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Exercises description 


This course includes the following exercises: 
¢ Exercise 1. Exploring BAW and creating your first process application 
e Exercise 2. Playback 0: Creating the To-Be process 
e Exercise 3. Playback 0: Controlling process flow 
e Exercise 4. Playback 1: Controlling process flow with business data 
e Exercise 5. Playback 1: Business data, services, and coaches 
e Exercise 6. Playback 1: User interface design and implementation 
e Exercise 7. Playback 1: Conducting the Playback session 
e Exercise 8. Playback 2: Integrations 
¢ Exercise 9. Playback 3: Handling errors and deploying your process application 
e Exercise 10. Implementing the "four eyes" policy by using a team filter 
e Exercise 11. Building a cancellation pattern 
e Exercise 12. Building web service connections 
e Exercise 13. Handling content events in a process 


In the exercise instructions, you can check off the line before each step as you complete it to track 
your progress. 


Most exercises include required sections, which should always be completed. It might be 
necessary to complete these sections before you can start later exercises. Some exercises also 
include optional sections that you might want to complete when you have sufficient time and want 
an extra challenge. 


This course has been tested in Firefox. Firefox is the default browser. However, Chrome is 
available. Keep in mind, the behavior may be different. If Firefox prompts to install updates, decline 
the updates. 


Q Important 


Online course material updates might exist for this course. To check for updates, go to the Instructor 
wiki at: http://ibm.biz/CloudEduCourses 
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Exercise 1. Exploring BAW and creating 
your first process 
application 


Estimated time 


01:30 


Overview 


This exercise introduces Business Automation Workflow and its primary components. It concludes 
with the creation of your first process application using IBM Process Designer. 


Objectives 


After completing this exercise, you should be able to: 
e Start IBM Business Automation Workflow 
e Access the Process Portal and Workflow Center 


¢ Create a process application using IBM Process Designer 


Introduction 


IBM Business Automation Workflow is a platform to create workflow applications to improve 
productivity. 


Workflow applications coordinate work between tasks that are performed by humans and 
automated tasks to improve daily business operations. Workflow applications have four main 
components: 


« An authoring environment to create and configure the application. 

« Frameworks or models for sequencing and delegating work. With Business Automation 
Workflow, the models can be either structured processes or unstructured cases. You can 
choose your model based on the pattern of your workflow and not be limited to a case or a 
process. 

= A.user experience for interacting with the application. To provide consistent user 
experiences, standardized workflows can be reused across the organization. 

« Administrative tools for optimizing how the application runs, deploying new versions and 
managing security. 


IBM Business Automation Workflow is part of the IBM Digital Business Automation platform, which 
includes various product offerings that you can use to digitize all aspects of business operations, 
while providing real-time insight into your business. IBM Digital Business Automation is a flexible 
automation platform that automates repetitive human tasks, content management, process 
workflows, data capture, and business decisions. 
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Requirements 


None 


ale Important 


The exercises in this course use a set of lab files that might include scripts, applications, files, 
solution files, project interchange files, and others. The course lab files can be found in the following 
directory: 


C:\labfiles for the Windows platform 


The exercises point you to the lab files as you need them. 
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Exercise instructions 


Each exercise in this course contains one or more of the following parts: 
¢ An introduction 
¢ Aset of instructions 


¢ Achallenge exercise 


How to use the course exercise instructions 


Text highlighting in exercises 


Different text styles indicate various elements in the exercises. 

Words that are highlighted in bold represent GUI items that you interact with, such as: 
e Menu items 
e Field names 
e Icons 


¢ Button names 


Words that are highlighted with a fixed font include the following items: 
¢ Text that you type or enter as a value 
¢ System messages 
¢ Directory paths 
* Code 


Exercise structure 

Each exercise is divided into sections with a series of steps and substeps. The step represents an 
action to be completed. If required, the substeps provide guidance on completing the action. 
Example: 
__1. Create a user account named: ADMIN 

__a._ Right-click My Computer and click Manage. 

__b. Expand Local Users and Groups. 

... continue 


In this example, the creation of a user account is the action to be completed. The substeps 
underneath provide specific guidance on how to create a user account. (In this example, the 
instructions are for the Windows operating system.) Words that are highlighted in bold represent 
menu items, field names, and other screen elements. 
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Tracking your progress 


Based on the actions that are mentioned in the lab, you can continue to perform steps on your own 
without using the substeps that are provided, or you can use all the substeps. As soon as you 
complete the action, you should review the substeps that are mentioned to verify your steps. 


If you face any trouble or encounter errors while working on the exercise, you should go back and 
review your steps to find out whether you correctly completed the steps and did not miss any steps. 


After completing the exercise, you are encouraged to go back over all the steps to make sure that 


you understand why you did each step and how you did it. 


An underscore precedes each numbered step and lettered substep. 


You are encouraged to use these markers to track your progress. As you complete a step, place an 


X or a check mark on the underscore to indicate that it is completed. By tracking your progress in 
this manner, you can stay focused when you experience interruptions during a lengthy exercise. 


User IDs and passwords 


The following table contains a list of user ID and password information for this course. 


Entry point User ID 
Windows Server 2016 administrator 
IBM Process Designer authori 


WebSphere 
Application Server cell administrator 
administrator 


Password 
password 


password 


password 
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Q~ 


Course updates and errata 


“ A Course Corrections document might be available for this course. 


provide this document to you. 


eo 
4 oy 
$s 4 If you are taking the class with an instructor, the instructor can 
Infor 


If you are taking the course in a self-paced environment, the course 
corrections document is provided with the other manuals. 


To check whether a Course Corrections document exists for this course: 


1. 
2; 
3. 


© Copyright IBM Corp. 2019 


Go to the following URL: http:/Awww.ibm.com/developerworks/connect/middleware_edu 
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Exercise instructions 


Part 1: Start the IBM Workflow Center deployment environment 


Before you can start the IBM Workflow Center deployment environment, three server configurations 
must be started. After logging on to the lab environment, start the Deployment Manager profile, the 
Node Agent profile, and the Deployment Environment. 


> Important 


All three server configurations must be started in order, starting with the Deployment Manager 
profile, then the Node Agent profile, and followed last by the Deployment Environment. To 
accomplish this task, the product provides a Quick Start routine to run the server start in that order. 


__ 1. Start the Workflow Center server. 


__a. Click the Windows Icon. 


=D: 


ry 
| IBM DB2 DB2COPY1 (Default) 


2 18M Installation Manager 


__c. Click ProcessCenter Quick Start. 


ct 
Ee Profile Management Tool 


ay, Start the deployment manager 


4%) Start the node agent 
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d. Inthe IBM Business Automation Workflow Quick Start window that opens, click the 
Start the Workflow Center Deployment Environment link. 


©@ 18M Business Automation Workflow Quick Start 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick Start for 
ProcessCenter with profile DmgrProfile 


Deployment environment administration 


Start the Workflow Center Deployment Environment. Start all configured clusters, node agents, and 
servers that control the Warkflaw Center 


e. It takes a while for the deployment environment to get started. A command prompt 
window runs through the start of the Deployment Manager profile, Node Agent profile, 
and Deployment Environment. Allow the entire start process to complete. The Quick 
Start window displays that the environment is starting. It can take about 10 — 20 minutes, 
so make sure that you provide ample time for this initial start. 


7) IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick Start for 
ProcessCenter with profile DmgrProfile 


Deployment environment administration 


The Workflow Center deployment environment is starting. 
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__f. Switch to the newly open command window. When the environment starts, the Press 
any key to continue message is displayed. When prompted, press any key. You might 
have to press a key multiple times, at which point the command window closes. 


HS C:\Windows\system32\cmd.exe — O x 


Logging to file C:\IBM\Workflow\v18.0\logs\config\BPMConfig_20190424-094421.log. 
Starting deployment manager profile DmgrProfile. 
CWUPO@@01I: Running configuration action detectNewProducts.ant 
ADMU@116I: Tool information is being logged in file 
C: \IBM\Workflow\v18.0\profiles\DmgrProfile\logs\dmgr\startServer.log 
ADMU@128I: Starting tool with the DmgrProfile profile 
ADMU310@I: Reading configuration for server: dmgr 
ADMU32@0I: Server launched. Waiting for initialization status. 
ADMU3@@0I: Server dmgr open for e-business; process id is 2296 
Starting node Node1. 
CWUPO@@01I: Running configuration action detectNewProducts.ant 
ADMU@116I: Tool information is being logged in file 
C: \IBM\Workflow\v18.0\profiles\Node1Profile\logs\nodeagent\startServer.lo 

8 
ADMU@128I: Starting tool with the NodelProfile profile 
ADMU3100I: Reading configuration for server: nodeagent 
ADMU32@@I: Server launched. Waiting for initialization status. 
ADMU3@@0I: Server nodeagent open for e-business; process id is 3504 

Starting cluster SingleCluster. 
When the BPMConfig command is used to start a deployment environment, it invokes the 
processes that are used to start the associated clusters. If the command is success 
ful in invoking the processes, it returns a message to report that the command compl 
eted successfully. However, to determine whether the cluster members were all starte 
d successfully, you need to check the log files of the cluster members. The log file 
$s are located in <profile_root>/logs. 

The 'BPMConfig.bat -start -profile DmgrProfile -de ProcessCenter’ command completed 
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__g. The Quick Start window refreshes and updates the display. It might take up to 10 — 20 
minutes for the servers to fully engage depending on the hardware configuration. Wait 
for the four sections to be populated in the IBM Business Automation Workflow 
Quick Start window (Deployment environment administration, Administration consoles 
and tools, Process application consoles and tools, and Documentation). 


?) IBM Busievwss Automation Workflow Quick Start - 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick Start for ProcessCenter 
with profile DmgrProfile 


Deployment environment administration 


Stop the Workflow Center Deployment Environment. Stop all configured clusters. 


Administration consoles & tools 


Manage applications, buses, servers and resources within the administrative domain. Monitor and control managed 
nodes and their resources 
WebSphere Application Server Administrative Console 


Administer the workflow servers in your environment, including the users and installed snapshots for each server. 
Manage queves and caches, and view and manage process instances for process applications. 


Process Admin Console 


Work with Performance Data Warehouse queves, manage data transfer errors, and monitor overall performance 
Business Performance Admin Console 


Process application consoles & tools 


Create, manage, share, and test high-level containers such as process applications and toolkits. 
Process Center Console 


Test and administer the business user interface for completing tasks. 
Process Portal 


Documentation 
Learn about the capapuities and features of IBM Business Automation Workflow 
Knovdedge Center 
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___2. The Workflow Center includes a repository for all processes, services, and other assets 
created in IBM Process Designer. The Workflow Center Console provides the tools that you 
need to maintain the repository. You now connect to the IBM Workflow Center console. 


__a. Click Process Center Console in the IBM Business Automation Workflow Quick 
Start window. 


?)) IBM Busivwess Automation Workflow Quick Start 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick Start for ProcessCenter 
with profile DmgrProfile 


Deployment environment administration 


Stop the Workflow Center Deployment Environment. Stop all configured clusters. 
k ner ment Ervi ry 


Administration consoles & tools 


Manage applications, buses, servers and resources within the administrative domain. Monitor and control managed 
nodes and their resources 
WebSphere Application Server Administrative Console 


Administer the workflow servers in your environment, including the users and installed snapshots for each server 
Manage queues and caches, and view and manage process instances for process applications 
Process Admin Console 


Work with Performance Data Warehouse queves, manage data transfer errors, and monitor overall performance 
Business Performance Admin Console 


Process application consoles & tools 
Frastea manana chara ang test high-level containers such as process applications and toolkits. 


Process Center Console 


Test and administer the business user interface for completing tasks. 
Process Portal 


Documentation 
Learn about the capabilities and features of IBM Business Automation Workflow 
Knowledge Center 


e@ Information 


The new terminology for Process Center is Workflow Center. While the new term is used 
throughout the product, there are times when the product still makes a reference to Process Center. 
The Process Center Console link that you just clicked is one such example. 


__b. Minimize both the IBM Business Automation Workflow Quick Start window and the 
ProcessCenter Quick Start command window so that you can use the page to access 
other links later in the exercises. 
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__c._ Ifa Firefox security warning message is displayed then it is safe to ignore that. Click 
Advanced to continue. Depending on the security message you may have to click few 
times. 


Warning: Potential Security Risk Ahead 


Firefox detected a potential security threat and did not continue to self-signed.badssi.com. If you visit this site, 
attackers could try to steal information like your passwords, emails, or credit card details 


0 Back (Recommended | Advanced... 


Report errors like this to help Mozilla identify and block malicious sites 


__d. A loading screen and then a login screen are displayed for Workflow Center. 
__e. Enter authori in the User name field and passwO0rd in the Password field. 


__f. Click Log In. 


Workflow Center 


User name 


| author1 | 


Password 
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__g._ The first time that you open the Workflow Center console, the Getting Started with IBM 
Workflow Center 8.6.1.19001 window is displayed. 


Getting Started with IBM Workflow Center 8.6.1.19001 
= Need Help? 
7 nested ee 


eee Community and support 
, 


Commumy waa 


IBM Support 
IBM Business Automation 
Workflow FAQ 
* 
42% What do you want to do? Ba What do you want to know? Desktop Process Designer 
+ (deprecated) 
* Create & process * Business automation workflow overview Use the web Process Designer instead of 
* Participate in a process * Reference information the deprecated deskiop Process Designer 
© Acrninisier a process * What's new? Leann more 
* Measure and improve a process instructions to inatall the deskiop Process 
® Adrninistor the Workflow Center repository Dosagnor 


__ 3. Review the Getting Started with IBM Workflow Center 8.6.19001 page. 


a. The Need help section takes you to the IBM Knowledge Center for the product. Click 
the View online help topics link. This link opens the product documentation page in a 
new tab. When you are done exploring it, close that tab. 


Need Help? 
View online help topics 


b. The Community and Support section provides important connections to additional 
assets and contributions from experts and connects with the IBM team. Click the links 
for Community wiki, IBM Support, and IBM Business Automation Workflow FAQ 
and explore them. When you are done exploring, close the newly open tabs. 


e@e Community and support 
» Community wiki 


IBM Support 


IBM Business Automation 
Workflow FAQ 
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The What do you want to do section direct you to some specific actions that might be 
important to you and provides detail explanation and steps around those specific 
actions. Click any specific action of interest to explore. When you are done exploring, 
close those open tabs. 


3% What do you want to do? 


Create a process 


Participate in a process 
Administer a process 
Measure and improve a process 


Administer the Workflow Center repository 


The What do you want to know section is another similar section that provides some 
important information regarding the product. The What’s new topic, in particular takes 
you to a page that lists the updates in the new release, in this case BAW V19.0.0.1. 
Click the What’s new link to explore the new updates. When you are done exploring, 
close the newly open tab. 


EE What do you want to know? 


® Business automation workflow overview 


*® Reference information 


© What's new? 


The Desktop Process Designer section provides a link to download the desktop 
Process Designer. Note that desktop Process Designer is deprecated. You no longer 
use the desktop Process Designer since the entire designer capabilities are now 
available in the Process Designer that you access through the Workflow Center. Do 
NOT click Download. 
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f. When you are done exploring, close the Getting Started page by clicking the X that is 
displayed in the upper right corner. You can always come back to the Getting Started 
page by clicking Launch Getting Started. Note that the Launch Getting Started link is 
displayed only after you click the X and close the Getting Started window. 


* Create New Process App 
& \Import Process App 


$= Download desktop Process 
Designer (deprecated) 
I eam more 


%, Launch Getting Started 


(7) Process Applications 
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Part 2: Explore the Workflow Center console 


1. 


Exercise 1. Exploring BAW and creating your first process application 


The Workflow Center console provides the tools that you need to maintain the repository. 
The Workflow Center console provides a convenient location in which to create and 
maintain high-level containers such as process applications and toolkits. Administrators can 
use the Workflow Center console to provide a framework in which analysts and developers 
can build their processes and underlying implementations. Another primary task for 
administrators is managing access to the Workflow Center repository by setting up the 
appropriate authorization for users and groups. In this section, you explore the various 
capabilities of the Workflow Center. 


a. 


The Workflow Center console provides a convenient location in which to create and 
maintain high-level containers such as process applications and toolkits. By default, the 
first time you access the console, it displays a list of process applications that are 
available in the Process Apps tab. 


Process Apps Toolkits Servers Admin 


Sort By 


¢{5 Performance (SYSPERFDB) 


Last updated on 4/4/19 by authort 


{5 Process Portal (SYSRP) 


Last updated on 4/4/19 by author! 


{5 Heritage Process Portal (deprecated) (TWP) 


Last updated on 4/4/19 by author 


¢{S Procurement Sample (STPPS1) 


Last updated on 2/1/19 by author? 


¢{S Hiring Sample Advanced (HSAV1) 


Last updated on 2/1/19 by author 


¢{5 Discover BPM UI Sample (DBPMUIS) 


Last updated on 2/1/19 by author 


¢{2 Hiring Sample (HSS) 
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Exercise 1. Exploring BAW and creating your first process application 


b. You can either create process applications in Workflow Center or export and import 
process applications into Workflow Center. After a process application is created or 
imported, it is stored and listed in the Workflow Center repository. You open process 
applications in Process Designer where you can create and edit the business processes 
within those process applications. You use Process Designer in the next section in this 
exercise. Note to the right of the console, there are links to import or create process 
applications. Do not click them yet since you work with these options in the exercises 
that follow. 


* Create New Process App 


® Import Process App 


$= Download desktop Process 
Designer (deprecated) 
l eam more 


c. Click the Toolkits tab. 


d. Process applications can share library items from one or more toolkits, and toolkits can 
share library items from other toolkits. The Toolkits tab displays a list of toolkits that are 
currently available in the repository. 


— = 


Sort By. Recently Updated v All | we Favorites | Subscnptons | Shared | Archived 


rr UI Toolkit (SYSBPMUI) «< 
Last updated on 4/4/19 by author? + 
ry SAP Guided Workflow (deprecated) (SGW) « 
2 upGated on 4/4/19 by authort al 
iam System Governance (TWSYSG) o 
2 updated on 4/4/19 Dy author! a 
ry Dashboards (SYSD) 

Last updated on 4/4/19 & author! . 
= Content Management (SYSCM) < 
ma Responsive Portal Components (SYSRPC) « 

- 
__e. Click the Servers tab. 
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__f. The servers tab lists any Workflow Servers that are connected to the Workflow Center. 
When working with IBM Integration Designer, developers deploy the integration 
modules to a workflow server, which can be connected to the Workflow Center. Once 
connected, it is visible in the Servers tab. Integration Designer is beyond the scope and 
is not covered in this course. Since you do not work with IBM Integration Designer or the 
Workflow server in this course, there is no server that is listed in the Servers tab. 


Process Apps Toolkits Admin 


__g. Click the Admin tab. 


__h. From this page, you can perform administrative tasks such as granting access to the 
Workflow Center repository and adding Users and Groups. 


Process Apps Toolkits Servers 


Activity Log Registration 


~ 44, tw_admins 
44, tw_authors 


__i. Switch back to the Process Apps tab. 
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Part 3: Create a process application 


Before you can explore IBM Process Designer, you need a process application that you can work 
with. In this course, you work with a Hiring Request Process application. You create that process 
application in this section. In the subsequent lab exercises, you build all the required artifacts, 
specifying more details as you progress. 


__1. Create a process application. 


a. Inthe Process Apps tab, click the Create New Process App link on the right pane of 


*} Create New Process 
App 


IBM Process Designer. 


® Import Process App 


$= Download desktop 
Process Designer 
(deprecated) 


Learn more 


__b. When the Create New Process App dialog box is displayed, enter following values: 
- Set Process App Name to: HR Recruitment Process 
- Set Acronym to: HRR 


- Set Documentation to: Contains HR processes that are used for recruitment. 
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- De-select (Uncheck) the Open in Process Designer option. 


Create New Process App 
Process App Name: 


HR Recruitment Process 
Acronym: 


HRR 


Documentation: 


B\1|Uf ton vf) S| S]3=|:=\¢ 


he ed 


Contains HR processes that are used for recruitment 


Open in Process Designer 


__c. Click Create. 


Create 


Process Apps Toolkits 


Servers 


__d. Verify that the process application is created and is now in your list of process apps. 


Admin 


Sort By. Recently Updated v 
ef HR Recruitment Process (HRR) « © 


All | w Eavonites | Archi 
< 
ofS Performance (SYSPERFDB) < 
Last updated on 4/4/19 by author1 
{5 Process Portal (SYSRP) 


7) 
Last updated on 4/4/19 by author! 
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___2. Manage the HR Recruitment Process process application. 


__a._ Inthe Workflow Center, find the newly created HR Recruitment Process (HRR) 
process application and click it. 


Toolkits Servers Admin 


Sort By.| Recently Updated v| All | w Favorites | Archi 


+ 

ofS Performance (SYSPERFDB) ™ 
Last updated on 4/4/19 by author’ ba 

{5 Process Portal (SYSRP) < 


Last updated on 4/4/19 by author! 


__b. By default, the Snapshot tab displays all snapshots for the process application. 
Snapshots record the state of items within a workflow project at a specific point in time. 
You can create snapshots in the Workflow Center console or in IBM Process Designer. 
You can also create new snapshots here. You do that later. 


Process Apps Toolkits Servers Admin 


+ HR Recruitment Process (HRR) 
+ Create 


History Manage Governance New 
Snapshot 


Sort Snapshots By: Date | All | installed | Deployed | Archived 


$ Open in 
igner 
& Current Designe 
Last changed on 5/6/19 by author? 
P Validation Errors and Wamings By Tyne @ Snapshots 
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__c. Click the History tab. The entries that are listed in this tab represent the history for the 
selected process application or toolkit. For example, you can see the date and time that 
the process application or toolkit was created. 


Process Apps Toolkits Servers 


+ HR Recruitment Process (HRR) 


Snapshots Manage Governance 


HR Recruitment Process process app modified by author! on 5/6/19 at 1:20:07 PM 
Main track was created by author? on 5/6/19 at 1:20:06 PM 


HR Recruitment Process process app created by author! on 5/6/19 at 1:20:05 PM 


d. Click the Manage tab. Here you can allow users to create tracks in a process app. 
Tracks allow parallel development to occur with isolation from changes in other tracks. 
For example, tracks enable one team to fix the current version of a process while 
another team builds a new version based on new external systems and a new corporate 
identity. If additional tracks are necessary for a process application, you can enable 
them at any time. 


Allow users to create tracks In this process app 


wo ORE. 


__e. Inthe upper right of the console, you can see the option to Archive Process App. 
Before you delete a process app, it must be archived first. You do that later. 


@ Archive Process App 


® View Archived Tracks 


@ Managing process applications 
and toolkits 
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__f. Inthe bottom half of the page, you can add users and groups as users of the process 
application. You can also configure their level of access. 


Manage Access to Process Library 


Add Users 


Add Groups 


___g. Click the Governance tab. You can apply a governance process that provides control 
over the installation of process applications or notifies people when a snapshot is 
installed or changes status. 


h. Switch back to the Process Apps tab. Next, you open the process application in IBM 
Process Designer. 


Part 4: Explore IBM Process Designer 


The Process Designer is the primary modeling and designing tool in IBM Business Automation 
Workflow. It is an editor that you access in a browser to model, implement, and inspect business 
processes. In this portion, you explore IBM Process Designer. 


__1. Start IBM Process Designer. 


__a. Inthe Process Apps tab, find the HR Recruitment Process (HRR) process application 
and click Open in Designer. 


Process Apps Toolkits Servers Admin 


Sort By: Recently Updated v| All | w Favorites | 


+f HR Recruitment Process (HRR) 
oo 
Last updated on 5/6/19 by authort 


ef, Performance (SYSPERFDB) 


Last updated on 4/4/19 by authort 


< 
+ 
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__b. Note that Process Designer opens in the Designer view. The Inspector view link is also 
listed and is used to run and debug your processes, services, and tasks during iterative 


development. 


[™ Process App Settings ~ -) @ Last updated 57 minutes ago by you MN ate 
HR Recruitment Process : Overview Environment Variables Servers 
— 
User Interface Name HR Recruitment Process 
Occumentaton: = | Boy Ul ee ml = lee 


___2. Explore the Library. IBM Process Designer offers several tools to ensure that you can 
quickly and easily access items that you work with regularly. The library organizes and helps 
in managing the assets and artifacts. 


__a._ Click the library icon indicated by three horizontal lines. 


INSPECTOR 
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b. Clicking the library icon expands or collapses the left pane. You can create, view, and 
work with several artifacts listed in the library. The HR Recruitment Process that is 
listed at the top is the newly created process application and serves as the container for 
all the assets listed below. 


DESIGNER INSPECTOR 


User Interface 
Services 
Events 


Teams 


Data 


Performance 


Files 


Toolkits 
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__c. Hover the mouse inside the library. Note the display of a plus + icon to the right of the 
library pane. Clicking the plus icon next to a library item, lets you create a new artifact of 
that item type. Click the newly displayed plus icon next to Processes. 


HR Recruitment Process 


User Interface 
Services 
Events 
Teams 

Data 


Performance 


) 
) 
) 
) 
i) 
® 
) 


Files 


© 


Toolkits 


__d. Note that a window opens to the right. You have an option to create a new Process. 
Clicking Process opens a new window. Do not click that as you create new processes in 
later exercises. 


ai HR Recruitment Process Overview Environment Variables 


a i 
a 


©] Siueworks Live Subscription 


0 User Interface 
a, Lm 


e. Click anywhere outside of the library to collapse the expanded library item and return 
focus. 
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__f. Inthe Library, click Processes to work with an existing process. Since there are no 
processes in the process application, it is currently empty. 


os HR Recruitment Process =~ 


il User Interface 


__g. Feel free to explore the other library items. Keep in mind that you work with and create 
several assets from these library items in this course. 


h. Click the Library icon again. Clicking the Library icon expands or collapses the library 
window. When you work in Process Designer, use this library feature often to make 
more space available in the working area. 


DESIGNER INSPECTOR 


[™ Process App Settings ~ ~) @ Last upde 


Overview Environment Variables Server 


Y Common 


Name: HR Recruitment Process 


Documentation: BIU 
3= 


Contains HR processes that are | 
recruitment. 


__i. Feel free to continue to explore IBM Process Designer. 


3. Save your work in IBM Process Designer. By default, the Process Designer is in the 
automatic save mode: In this mode, every change that you make is automatically saved as 
you make it. As a result, when you close an editor or the browser crashes, your changes are 
still preserved. 


__a._ The Finish Editing icon is represented by a check mark. 


A ¢ [o|m 


© Copyright IBM Corp. 2019 1-26 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 1. Exploring BAW and creating your first process application 


__b. Inthe Common section to the right, enter Test at the end of the description of the 
process application. 


DESIGNER INSPECTOR 


[ Process App Settings®. ~) @ __ Last updated seconds ago t 
Overview Environment Variables Servers 
Name: HR Recruitment Process 
er 


Contains Hi sses that are used for 
recruitment 


c. Achange in the Process Designer artifact that is not yet saved is indicated by a number 
1 next to the check mark. Notice this change in the Finish Editing icon at the top. 


d. Click the Finish Editing icon to save your change. Note the number 1 is no longer 
displayed indicating that all your changes are saved. 


__e. Delete the newly added text: Test and save your change to bring it back to the way it 
was before. 


__ 4. Return to the Workflow Center console. 


__a. When you are done working in Process Designer and need to return to the workflow 
Center console, click the View the Workflow Center icon. Click that icon now. 


mo © Cc © Mizz 


___b. You are now back to the Process Apps tab in the Workflow Center console. 
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Part 5: Explore other tools 


In addition to working with the Workflow Center console, there are several other tools that one 
works with when developing applications in IBM Business Automation Workflow. You explore some 
of the key additional tools in this section. 


1. Explore the Administration console. The administrative console is used to administer 
applications, services, and other resources at a cell, node, server, or cluster scope. You can 
use the console with stand-alone servers and with deployment managers that manage all 
servers in a cell in a networked environment. 


a. Toaccess the administration console, go back to the minimized Quick Start window and 
click the WebSphere Application Server Administrative Console link. 


@ IBM Business Automation Workflow Quick Start - 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick Start for 
ProcessCenter with profile DmgrProfile 
Deployment environment administration 


Stop the Workflow Center Deployment Environment. Stop all configured clusters. 
Stop the Workflow Center Deployment Environment 


Administration consoles & tools 


Manage applications, buses, servers and resources within the administrative domain. Monitor 
control mananed nodac and their recourrec 


WebSphere Application Server Administrative Console 


Administer the workflow servers in your environment, including the users and installed snapshi 


__b._ If prompted, log in by entering author‘ in the User ID field and passwOrd in the 
Password field. Click Log In. 


WebSphere Integrated 
Solutions Console 
amen 


Password 


Log in 
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__c. Expand the Servers panel and click Deployment Environments. On this screen, you 
can start, stop, and create new deployment environments. You can also verify the status 
of a deployment environment. 

Deployment Environments 


Deployment Environments 


Select the deployment environments to manage. You can manage deployment environment that are created using patterns. 


Start Sto New... 


Select | Status > 


] | 
Oo | ProcessCenter | IBM Business Automation Workflow Advanced Workflow Center | Single Cluster 


Total 1 


__d. Expand the Resources panel, then expand the JDBC section and click Data sources. 


Deployment Environment Name * | Features > Pattern eS Description > 


__e. Scroll down to the bottom and click Training Course DB. This is the JDBC driver that is 
used later in the course. 


Cc | Training jdbc/TrainingDB Cluster=SingleCluster| DB2 Using 


| Course DB IBM JCC 
Driver 


__f. Scroll down to the bottom of the page and the data source properties are displayed. 


Common and required data source properties 


Name Value 


* Driver type 
* Database name [raining ( tti(‘i;OO!O!!O!;~*™% 
* Server name fws2016x64 t—“(‘OCOC‘*d 
# Port number [s0000—i (<i (‘(‘ié;;O;O;!OOC~*@™ 


__g. While logged in, feel free to explore the administrative console further. Optionally, click 
Logout to log out of the console. 
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___2. Explore the Process Admin console. The Process Admin Console is used to administer the 
process servers in your environment, including the users and installed snapshots for each 
server. In addition, it provides tools to help you manage queues and caches. 


__a. Toaccess the administration console, go back to the Quick Start window and click the 
Process Admin Console link. 


IBM Business Automation Workflow Quick Start 


IBM Business Automation Workflow Enterprise Quick | 
ProcessCenter with profile DmgrProfile 


Deployment environment administration 


Stop the Workflow Center Deployment Environment. Stop all configured cluster 
Stop the Workflow Center Deployment Environment 


Administration consoles & tools 


Manage applications, buses, servers and resources within the administrative de 
control managed nodes and their resources. 


WebSphere Application Server Administrative Console 


Administer the workflow servers in your environment, including the users and in 
for each server. Manage queues and caches, and view and manage process ir 


Process Admin Console 


Work with Performance Data Warehouse queues, manage data transfer errors 


muaeell aactaemanase 


b. If you logged out of the Administrative console, then you are prompted to log in to the 
Process Admin Console. Enter author in the User Name field and passwOrd in the 
Password field. Click Log In. 


c. When the Process Admin console is displayed, note the various links in the left pane. 


Process Admin Console 


& SingleClusterMe... 
| n 
> Workflow Admin pe Fe Process Status Summary 
>» User Management cera 
> Monitoring oe Cosy [weak J Month | voor [A 
> Event Manager and 
san “~—« @88o8@ 
> Alert Definitions tools for the Active Completed Failed Suspended 
Lap ancaantai pssceny your 
IBM Business  *ie Process Applications 
Automation Hontage Process Portal (deprecated) (TWP) 
Workflow Process Portal (SYSRP) 
environment Performance (SYSPERFDB) 
ay Hiring Sample (HSS) v 
< > 
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__d. Expand User Management and then click User Management. 


Process Admin Console 


p ff SingleClusterMe... 


» Workflow Admin 
i ¥ User Management 


tt User Management 
Meivuyp reed sayy re “ 

f Bulk User Attribute Assignment 
User Synchronization 

Cc > Monitoring 

) > Event Manager 


i} > Admin Tools 
> Alert Definitions 
>» Performance 


__e. Inthe Retrieve Profile field, enter * and click Retrieve to view a list of users. 


User Management > Maintain User Settings 


Retrieve Profile 
Retrieve 
File Registry Users User Details 
admmistrator U N 
authori ans 
userl Full Name 
2 
wes Password 
Confirm Password 


__f. Click Group Management in the left menu. 


__g. Inthe Select Group to Modify field, enter %% 
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__h. Examine the groups listed. Do not make any changes as it impacts the exercises. 
User Management > Group Management 
Select Group to Modify: %% 


New Group 
Debug 


PEWorkflowSystemAdmin 
tw_admins 

tw_allusers 
tw_allusers_managers 
tw_authors 

tw_managers 
tw_portal_admins 


tw_process_owners 


FRRFRFRPRFRR RE 


twem 


__i. As time allows, continue to explore the Process Admin Console. 


___3. Explore the Process Portal. From Process Portal, users can launch processes, dashboards, 
and startable services, and work on their tasks. 


__a.  Toaccess the Process Portal, go back to the Quick Start window and click the Process 
Portal link. 


IBM Business Automation Workflow Quick Start 


Administer the workflow servers in your environment, including the users and install 
for each server. Manage queues and caches, and view and manage process insta 
process applications. 


Process Admin Console 


Work with Performance Data Warehouse queues, manage data transfer errors, ar 
overall performance. 


Business Performance Admin Console 
Process application consoles & tools 


Create, manage, share, and test high-level containers such as process application: 


Process Center Console 


Tact and arminictor the bysiness user interface for completing tasks. 


[ Process Portal 
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__b._ If prompted to log in, enter author‘ in the Username field and passwOrd in the 
Password field. Click Continue. 


Business 
Automation 
Workflow 


Sign in to Business Automation Workflow 


Username 


authorl 


Password 


__c. The Process Portal default start page is the Work dashboard. Click the Main menu icon 
(indicated by three horizontal lines) in the upper left corner. 


4 Enter search text 
, i 
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__d. The main menu makes available other options on the left from which you can start 
dashboards and saved searches. It also provides a context menu that shows the 
process instances you are following and the posts that mention you. Do NOT click any 
processes that are listed under the Launch section as that starts a new process 
instance. You work with process instances in Process Portal in later exercises. 


Work 


author 


Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Work 
Processes 


7] Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


&’ Discover BPM UI 


= - —_—— v 


__@. Click Logout to log out of the console. 


author 


Edit Profile 


Dashboards 


Part 6: Access the enhanced Workflow Center 


The workflow center console that you worked with so far in this exercise is also called the classic 
Workflow Center. The classic Workflow Center includes a repository for all processes, services, and 
other assets created in Process Designer. 


There is also an enhanced Workflow Center console available, which is optimized for working with 
both processes and associated case solutions. Regardless of which interface is used, the projects 
reside in the same repository. 
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The focus of this course is on Processes and not Case. That is why you work with the Classic 
version throughout the course. 


1. In this portion of the exercise, you are introduced to the enhanced workflow Center. You 
work with the enhanced Workflow Center in the last exercise in this course when working 
with a Case solution 


a. Open a new tab in the browser. 
b. Inthe URL field, enter https: //ws2016x64 : 9443/workflowCenter 


c. If prompted to log in, enter author1 in the User name field and passwOrd in the 
Password field. Click Log In. The Welcome page for the enhanced Worklfow Center 
console is displayed. 


Welcome to Business Automation Workflow Center 


Create a new project or take a look at existing ones to get started! 


tia Va 


Process Apps Case Solutions Toolkits 


o o o 


___2. Explore Process Apps. 


__a. Click Process Apps. 
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__b. The page displays the available process applications. Note that the interface is different 
from the classic workflow center console interface. 


Process Apps 


: = 


HR Recruitment 
Process 


patted 


Procurement Sample 


Performance 


Process Portal Heritage Process Portal 
(deprecated) 


pete” atime 


o °§@ 


Discover BPM UI Hiring Sample 
Sample sauna < Danii 


Updated } montns ap 


__c. Click the HR Recruitment Process application that you created earlier. 
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__d. The process application opens in IBM Process Designer. Recall that this step is similar 
to clicking the IBM Process Designer link in the classic Workflow Center that you worked 


with earlier. 


@ Last updated 3 nours ago by you 


Overview Environment Variables Servers 


HR Recruitment Process 
Processes ¥’ Common | 


User Interface Name 
Documentation BIvulj= == 


Il 
iY 


= 
Contains HR processes that are used for 
recruitment. Test 


__e@. Click the View the Workflow Center link to go back to the console. 


CREATE NEW 


When back in the console, click the menu icon with three horizontal lines in the upper 


f. 
left corner to view more options. 


IBM Business Automation Workflow Center 


Toolkits 


| New | } import | 5 Sees 


UI Toolkit SAP Guided Workflow 
Updated : last month (deprecated) 
Updated - tast month 
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__g. Click Toolkits in the newly open window. 


> IBM Business Automation Workflow Center 


Getting Started 
Process Apps arch 


Case Solutions 


Toolkits 


__h._ The page displays the available toolkits. Note that the interface is different from the 
classic workflow center console interface. 


SAP C 


= 16M Business Automaton Workliow Conter 


Toolkits 


| i 


UI Toolkit SAP Guided Workfiow System Governance Dashboards 


eS (deprecated) 


Updsted ts 


sted west month Updated last mont 


© -@ 'e 'e 


Content Management Responsive Portal Responsive Coaches Coaches 
socket cate Components er = ae 


4 tt moe 
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__i. Click the icon next to the user author’ listed in the upper right menu. 


Recently Updatedy J All . 


) € 


vernance Dashboards 


__j. Click the Classic Workflow Center link that is now displayed. 


Class Workiow Cemter 


Recently Updated J All bd 


k. The classic Workflow Center console opens in a new browser tab. To continue working 
with the enhanced workflow center, you need to switch back to the previous browser tab 
that is still open. 


|. Feel free to continue exploring the enhanced Workflow Center. You work with this 
enhanced Workflow Center in the last exercise in this course when working with Case. 


m. When done exploring, close the enhanced Workflow Center and all other open browser 
sessions. Optionally, you can leave the classic workflow center console page open since 
you work with it in the next exercise. 
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Part 7: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a._ Inthe Process Apps tab, click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__c. Enter Exercise 1 solution for the name. 
__d. Click Create. 


__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
You can only export snapshots. 


__a. Click Export next to the snapshot. 


__b._ Inthe Export Process App window, click Export. It may take a minute or two to 
generate the . twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

( IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 


© Copyright IBM Corp. 2019 1-40 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 1. Exploring BAW and creating your first process application 


__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated w Favorites | Archived 


__h.. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


You are now ready to start building your process application. Each exercise shows step-by-step 
instructions that you can follow to complete the tasks. In IBM Business Automation Workflow, you 
find many different ways to complete modeling tasks. The step-by-step instructions show one way 
to accomplish these tasks in the exercises. 


End of exercise 
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Exercise 2. Playback 0: Creating the 
To-Be process 


Estimated time 


02:00 


Overview 


This exercise covers how to create a process using IBM Process Designer. The Hiring Requisition 
process owner provided detailed information about the process and its current state to the BPM 
analyst, who in turn documented the information. This step completed the process discovery and 
initial analysis, and now the process model can be created. To accomplish the task of creating the 
initial process model, you model it with a pool, lanes, and flow objects such as activities, and 
events, and nested processes. You take the information that is provided for the use case and 
translate that into a process. Your first task is to create a process and name it according to naming 
conventions. Add the activities in the appropriate lanes and use sequence flow to connect the 
activities. Be sure to model the happy path (critical path) first. You also complete decomposition on 
your process and create a linked process where you see the opportunity. 


Objectives 


After completing this exercise, you should be able to: 


¢ Translate business process workflow steps that are documented in the process discovery and 
analysis into process model tasks 


¢ Create the foundation for a process by adding the appropriate lanes to the default pool 
¢ Model the expected process flow for the initial process model 


¢ Decompose business process workflow steps that are documented in the process discovery 
and analysis into process model tasks 


¢ Create a linked process 


Introduction 


In the previous exercise, you created a process application. In this exercise, you model the process 
to be used for the application. 


In this exercise, you create a to-be process model. To accomplish the task of creating the initial 
process model, you define a pool, lanes, and flow objects such as activities, events, and a linked 
process. 


In this exercise, you add activities to the appropriate lanes and use sequence flow to connect the 
activities. As mentioned in the unit, you model the happy path first. Gateways and various flows are 
presented in the next exercise. 
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Finally, you create a subprocess and link it to the main process. 


Requirements 


Successful completion of exercise 1 because you start the environment in that exercise. 
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Exercise instructions 


Hiring Requisition process 


The company has expanded from the simple (as-is) hiring process to a more detailed (to-be) hiring 
process. The detailed process now includes more information. The process that you are going to 
examine and model is called the Hiring Requisition Process. The company also wants to move to 
reduce rework by introducing a more structured process for the Hiring Requisition process. This 
process covers a new job position through submission, approval, and completion so applicants can 
apply for the job position. 


Core requirements 


¢ 1.1: A Hiring Manager submits a hiring requisition to the HR Department. The request contains 
the following information: 


« Customer details: 
- Requisition number 
- Date of request 
- Requester 
- Date position available 
- Job title 
- Job description 
- Job level 
- Number of people managed 
- Division 
- Department 
- Salary to offer 
- Bonus amount 
- Hiring Manager comments 
- New position 


¢ 2.1: lf the answer to “New position” is Yes, the request is forwarded to a General Manager. After 
the General Manager receives the request, the General Manager indicates approval or 
disapproval. 


¢ 2.2: lf the request is not approved, the General Manager specifies a reason and the request is 
closed. If the request is approved, a salary compliance check is conducted. 


¢ 2.3: The Hiring Manager is notified of the General Manager’s decision after the General 
Manager approval step. 


¢ 2.4: After the requisition is submitted, an automated system checks for salary compliance. If the 
request meets salary compliance, the hiring request is automatically posted to the HR Positions 
database and made available for dissemination. 
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¢ 2.5: When a request violates the established salary guidelines of the company, the HR 
Administrator can approve or reject the requested salary override. 


¢ 2.6: If the salary override is approved, the request is posted to the HR Positions database and 
made available for dissemination. 


¢ 2.7: If the HR Administrator rejects the requested salary, the HR Administrator must provide 
comments for the violation, add a proposed salary, and send the request back to the Hiring 
Manager who originated the request. 


¢ 2.8: When the Hiring Manager gets the request back because of a rejection, the Hiring Manager 
can negotiate an adjusted salary or can cancel the request. If the negotiation is successful, the 
request is resubmitted back to the same HR Administrator. 


¢ 2.9: All hiring requests must be added to the HR Positions database regardless of the 
disposition at the end of the process during a finalization activity. 


¢ 2.10: The HR Administrator has 4 hours to complete the review. If the review is not completed 
within 4 hours, an email is sent to the HR Administrator. The email notifies the HR Administrator 
of the missed deadline. 


The process owner provides detailed information about the process and its current state to the IBM 
Process Analyst, who in turn documents the information and analyzes the process for 
improvement. The process discovery and initial analysis are already completed for you to proceed 
with the creation of the to-be process model. 


Part1: Import the process application solution from the previous exercise 


In this section, you import the exercise 1 process application solution that is required to start 
exercise 2. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 


__i. — If logged out, log back into the Workflow Center console by entering author‘ in the 
User name field and passw0rd in the Password field. Click Log In. 


__j. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


P Download desktop Process 
Designer (deprecated) 
Learn more 
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__k. Inthe Import Process App window, click Browse. 


Import Process App 
@) File: 
Select a file to import: 


Browse... No file selected. 


©) SAP Solution Manager (deprecated) 


__|. Browse to C:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise_1_solution.twx. 


__m. Click OK. 


__n._ Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


__ 0. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Create a process 
To add the process model to the HR Recruitment Process application you created in the last 


exercise, return to the Process Designer window. 


A process defines the activities that are needed to resolve a specific business problem. A process 
also defines who works on these activities and the steps they take to resolve the problem. At run 
time, a business user works with an instance of a process. 


__1. Create a process. 


__a. Open the HR Recruitment Process (HRR) process application. 


Process Apps Toolkits Servers Admin | Preferences| Logout “? : 


Sort By: Recently Updated v All | w Favorites | Archived 


{5 HR Recruitment Process (HRR) 17 


Last updated on 2/21/19 by author’ 


$ Open in [ oven in Designer] 


__b. From the process library, click the (+) plus sign next to Processes and select Process 
from the list. 


DESIGNER INSPECTOR 


[¥ Process App Settings v ©) @ Last updated 4 hours ago by you 


Environment Variables Se 


_ : 
fa HR Recruitment Processes Overview 


New 
Processes 


0 User Interface 6 | Blueworks Live Subscription 


rd) Note 


When developing web-based user interfaces, it is important to keep in mind the different ways in 
which different browsers render JavaScript. The screen that you see might vary slightly from the 
screen captures depending on how the JavaScript is being rendered in the browser. For instance, in 
the Chrome browser, it places a box around the highlighted tab. 


Overview Environment Variables 


Although the development environment might vary slightly, the most important aspect is to keep in 
mind how the user interface is displayed in the browser to be used with the solution. 


© Copyright IBM Corp. 2019 2-6 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 2. Playback 0: Creating the To-Be process 


Enter Hiring Request Process in the Name field. Click FINISH. 


New Process 


A process captures a set of activities and the data and content to support 
the activities. These activities can be part of a structured flow, ad-hoc 
activities that are not part of a structured flow, or a combination of the two. 


The process is created, and the initial view is shown under the Definition tab. By default you have 


a process with a team lane, a system lane, a start event, an inline user task, and an end event. 


Overview Variables Folders Views Tracking 


e » Inline User 0 


ey 


Task 
End 


___2. Expose the process to All Users so that all the users can start the process. 


For now, you assign all users to the Hiring Request process. In a later unit and lab exercise in this 
course, you learn how to define and assign a team and users to your process. 


Click the Overview tab. 


Definition Variables Folders Views Tracking 


2-7 
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__b. Under the Exposing section, click Select for the Expose to start option. 


v Exposing 


Expose to start: <none> New... x 
Expose business data: <none> | Select... | | New... x 
Expose performance metrics: <none> x 


__c. Select All Users. 


Select Library Item 


44 All Users System Data 


44 Background System Data 

44% Managers System Data 

4& Managers of All Users System Data 
4% Process Owner System Data 

4& System System Data 


__d. Click Finish Editing to save your changes. 


OQ Hint 


A number appears next to the check mark corresponding to the number of artifacts with unsaved 
changes. You can also use Ctrl+S to save your work. 
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Part 3: Create process activities 


To add activities and events to the process model, use the process requirements that are provided 
at the beginning of this exercise. Read the main process requirements and determine the activities 
from the requirements. Because the requirements were written down, it might be easier to write 
down the activities on paper before proceeding. Remember, activities use a verb-noun naming 
convention. If you read the requirements carefully, notice that the main process is described from 
item 2.1 through item 2.4. In the process requirements, four activities are in the main process: 
Submit Hiring Request, Approve New Hire Request, Approve Hire Request, and Complete Hire 
Request. 


__1. Create an activity that is named Submit Hiring Request. 


__a. Return to the Hiring Request Process by opening the History menu at the top and 
selecting Hiring Request Process. 


DESIGNER INSPECTOR 


[¥ Process App Settings| v | 
[¥ Process App Settings 


I| «| Hiring Request Process ® 
L 


__b. From the Hiring Request Process, click the Definition tab. 


Overview Variables Folders Views Tracking 


oo 
> Inline User <0) 
Task 


End 


Team 


__c. Drag an activity from the palette on the right side of the canvas into the Team lane to 
the right of the start event. When you drag an object to the canvas, the cursor turns into 
a green plus sign while you drag the object. 
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__d. Release the left mouse button to place the activity on the canvas to the left of Inline User 
Task1. 


Overview Definition Variables Folders Views Tracking 


a 


Inline User 


* Task 


Inline User 
Task1 


Q Hint 


As you model more artifacts, you can increase the size of the canvas by dragging the double lines 
on the line separating the model definition from the properties section. 


es 
+ 


Y Common 


Alternatively, you can toggle the Properties section to display by selecting the Properties icon in the 
bottom status bar of Process Designer. 


e. While Inline User Task‘ is selected, rename it Submit Hiring Request under the 
General > Common properties section. 


General 


Implementation Y Common 
Data Mapping Name: Submit Hiring Request 


Assignments Color: Oseesee — . ® é . 
Pre & Post ID: 730ce2b9-c930-48a6-9702-d0515b84faa6 
ae Documentation: BIUJ/JZESSPBl(E Ele = 
Conditions 
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__ 2. Create an activity that is named Approve Hire Request. 
__a. Click Inline User Task to the right of the Submit Hiring Request activity. 


__b. While highlighted, click the text on the activity to rename itas Approve Hire Request 
and press the Enter key to apply the name change. 


Overview Definition Variables Folders Views Tracking 


"a oO 
‘Approve Hire 
Ga Request Ly 
£ L) uN 
= Start Ca v 
Submit Hiring Z 
Request bam 


__c. Click the flow line between the Start event and the Approve Hire Request activity. Press 
the Delete key on your keyboard to delete the flow line. 


Overview Definition Variables Folders Views 


‘> ‘Approve Hire 
es © 
(> Request 


Qa 
Submit Hiring 
Request 
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__d._ Click the flow line between the Approve Hire Request and the End Event. This time, 
right-click the flow line and click Delete. 


Overview Definition Variables Folders Views Tracking 


a 


© Achill = 
ae xX Delete 
Start 3 


Submit Hiring Create control point 
Request Cut 


5 Copy 


feam 


Paste 


__e. Later in the course, you build custom front ends for these tasks. Click the Submit Hiring 
Request activity. In the properties panel at the bottom, go to the Implementation > 
Activity Type menu, expand Type, and change the setting to User Task. 


yes] : 
: SubmitHiring : 
: Re = = 

User Task 
Inline User Task 
(c4) Robot Task L__ 
System Task 
Decision Task 
= 
a SJ sort 


< laste) Subprocess 


Team 


ST 


General —) Linked Process 
Implementation |v _ Ada Event Subprocess | 
Data Mappin é - 
ee bee Inline User Task . 
Preconditions Promos Bn [ 


Assignments Y Implementation 
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f. Under the Implementation section, click the Select button and click Default UI Human 
Service. 


__g. Verify that the Default Ul Human Service implements your User Task. 


General : 
implementation VY Activity Type 


Data Mapping Type: User Task i 
Preconditions 


Assignments v Implementation 


Pre & Post 
Implementation: —_@ Default Ul Human Service |II Toolkit 


Tracking 


rd) Note 


Alternatively, you could continue to use the inline user tasks. An inline user task is an extension of a 
regular user task and automatically exposes the data that is mapped to the user task. Inline user 
tasks can be used to run the process immediately after an IBM Blueworks Live import. 


You also have the option to extend the inline user task by creating a stand-alone implementation. 
For the purposes of this training, you use the default Ul human service until you create the user 
interfaces in a later exercise. 


General 
Implementation v _ Activity Type 
Data Mappin : c 
apping Type: Inline User Task bed 
Preconditions 
Assignments Y Implementation 
Pre & Post 


An inline user task is an extension of a regular user task. Its interface 
Tracking is automatically defined by the data thatis exposed to it and an 
implementation is not required. Learn More 


View template: G) <default> x 
Create Stand-alone Implementation... 
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__h._ Click the Approve Hire Request activity. In the properties panel, go to the 
Implementation > Activity Type menu, change this activity to User Task. Both 
activities now have the same icon. 


Overview Definition Variables Folders Views Tracking 
é 
. 
= “Approve Hire 
5 > Request 
e Start fe i i 
Submit Hiring Sap te aber cs erica ; 
Request 
me . 
< > 
__ 3. Create an activity that is named Approve New Hire Request. 
__a._ Right-click the Approve Hire Request task and select Copy. 
. ode . 
ie . 
i, Approve Hire i 
i Request 
Align nodes > 
. 
pas Rename 
xX Delete 
Cut 
Paste 
__b. Right-click on the canvas and select Paste. 
Create lane above 
Create lane below 
Move lane up 
Move lane down 
Delete 
__c. Rename the task to: Approve New Hire Request. 
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__ 4. Create an activity named Complete Hire Request. 


__a. Expand the activity icon in the palette by clicking the down arrow and drag a User Task 
to the canvas. 


User Task: A task thatis performed by a person. Implemented 
by a client-side human service. 


__b. Rename the activity Complete Hire Request. 
__ 5. Sequence the activities and add sequence flow lines. 
a. Place the activities in line using the following sequence: 


Submit Hiring Request > Approve New Hire Request > Approve Hire Request > 
Complete Hire Request 


b. Lasso all objects by holding down the left mouse button and highlighting all objects 
including the start and end events. After all are highlighted, release the mouse button. 


Overview Definition Variables Folders Views Tracking 


Submit Hiring Q Complete Hire 


Request aria New 2 Request 


a 
Hire Request Approve Hire 
Request 


c. With all items highlighted (yellow halo denotes selection), right-click one of the items 
and select Align > Middle. The result is all artifacts are aligned. 


'e a Se a a 
Submit Hiring H 


Complete Hire 


Start Request “appt Alignnodes » ("ii Too Request e) 
oD cigs f 
, if) Rename off Middle |® 
H End 
Zn 9 Delete ot? Bolom 
Cut sa Left 
Copy a Center 
o 2 
Paste me: Right 
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d. Highlight the Start event until you see the right-arrow connector. 


> 
wr 


Start 


e. While holding down the left mouse button, drag the arrow until it connects to the first 
activity. When the cross displays and the activity is highlighted, you can release the 
mouse button. 


ry ‘Bubmit Hiring | 
7 . 
Ne > | Request 

Start r —— 


f. Repeat adding sequence flows for the remaining activities. 


__g. Click Finish Editing to save your changes. Your process should resemble the screen 
capture below. 


aa > “Submit Hiring > “Approve New > "Approve Hire > ‘Complete Hire 5@) 
XY Request Hire Request Request Request 
Start End 


Although this is the correct sequence of activities in the process, the roles that complete the 
activities have not been defined yet. You do this in the next section. 
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Part 4: Model the process teams 


When creating a new process, by default you have a team lane, a system lane, a start event, and 


an end event. In this section, you add the necessary team lanes to the two default lanes (team and 
system) and rename the lanes. 


__1. Adda team lane to the process. 


__a. Read the core requirements in this exercise, pages 2-3 and 2-4, and identify the teams. 


In the process requirements, two teams are in the main process: Hiring Manager and 
General Manager. Also, the process has one System lane for a total of three lanes. 


__b. Click the Lane icon and drag one lane from the palette to the canvas above the Team 


lane until you see the green (+) symbol. When you release your mouse button, the new 
lane appears. 


| Lane: A container for the activities and events in a process. A 


| pe & 
Tracking | lane usually groups activities that are completed by members 


Overview Definition Variables Folders Views 
| ofateam. 


\ “Submit Hiring “Approve New “Approve Hire ‘Complete Hire 
E \ew/ > Request | Hire Request 7 Request > a0) 
@® 
= 


Request 
End Ov 


__c. Alane with name Team1 is added to the process. 


Overview Definition Variables Folders 


Views Tracking 
. | 
= 
= 
HY 
Re 
ao a) ao a 
an Submit Hiring Approve New Approve Hire Complete Hire 
= \es/ Request Hire Request > “Request » Request *O 
fe Start1 End 
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__2. Set the properties of the team lanes. 


___a. Click the top lane to select the entire lane. The General Properties tab populates at the 
bottom of the screen. 


Overview Definition Variables Folders Views Tracking 


a a e) a 

Submit Hiring > Approve New Approve Hire > Complete Hire 2 @) 
Request Hire Request Request Request 

Start1 End 


© 


> 


Team 


General 


Y Common Y Behavior 


Name: Defaultlane team: All Users System Data| Select 


i * 
Color: @ é Is system lane: O 
ID: 341b46c1-d8d5-41f3-86c2-c7b8053adbc2 


Documentation: BIU|== = = | 


b. Inthe General > Common section, change the name of the top lane to: Hiring 
Manager 


___3. Rename the second lane labeled Team. 
a. Select the lane that is labeled Team and double-click the name. 
b. Change the name of the middle lane from Team to: General Manager 


This step leaves the bottom lane as the System lane. It is a good practice to keep the 
System lane at the bottom of your process, even if you have no system lane activities 
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Your process model now has the appropriate Team lanes defined. However, the activities are not 
assigned to the appropriate Team lanes. You complete this activity in the next section. 


i 
o 
c=.) 
< 
o 
= 
a 
£ 
= 
Submit Hiring > Approve New > Approve Hire > Complete Hire <@) 
eo Request Hire Request Request Request 
Start1 End 
= 
a 
= 
o 
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Part 5: Assign the activities to the appropriate Team 


You identify the teams that are associated with the lanes instead of allowing all users to claim the 
tasks that are associated with each activity. Determine which teams conduct each of the four 
activities. From the process requirements, determine the following assignments: 


¢ Hiring Manager (team): Submit Hiring Request 
¢ General Manager (team): Approve New Hire Request 
¢ System (team): Approve Hire Request and Complete Hire Request 
__1. Arrange the activities to the team lanes to establish the correct activity assignment. 


__a. Select the first two items in the process. To drag the Start event and the Submit Hiring 
Request activity to the Hiring Manager lane, lasso both items by highlighting a box 
around both items with your cursor. 


2 
ca Ca 
Submit Hiring > Approve New 
Request Hire Request 


General Manager 
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__b. With the two items highlighted (yellow halo), drag the selected activities to the Hiring 
Manager lane. 


AUNEIARIAROARIOAORRIARUARAAROORHORIAMENARAARIAENL 


'e - Submit Hiring | 
: Request i 


— 
@® 
i= 2) 
oO 
= 
o 
= 
i=) 
= 
= 
= 


“Approve New 
Hire Request 


General Manager 


__c. Leave the Approve New Hire Request activity in the General Manager Team lane and 
drag the Approve Hire Request and Complete Hire Request activities, along with the 
End event, to the System lane. Later in the exercise you rearrange this activity in a new 
lane: Approvers. 


__ 2. Add annotation 


It is common to place annotations in the process when first modeling it. They can serve as 
placeholders for questions or concerns while the process is in development. The process owner 
has expressed that the approval process might involve multiple steps and departments. Thus, 
an annotation is placed in the model mentioning this step might be a potential subprocess. At 
this point, it might not be known whether it is to be implemented as a linked process or 
subprocess. 
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__a. Drag an annotation to the canvas next to the activity Approve Hire Request. 


7s Oo 


__b. Double-click the annotation and add the text: Potential sub-process. 


__c. Highlight the annotation until an arrow appears and draw a line from the annotation to 
the activity Approve Hire Request. 


& 
Approve Hire 


>» “Request 
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__d. Save your process. The first process is complete for this exercise. Next, you create 


another process, a linked process. 


© ¢ 

mo - 
oc Submit 
a e) > Hiring... 
o Start 

£ 

= 

o 

Lo] 

= ¢ 
oO 

= 

S 

@D 

= 

ao 

oO 


Approve Hire — 
Request 
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Hire Request 


Complete 
* Hire Request 40) 


End 
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Part 6: Create a linked process 


Determine whether any additional work is required for each activity and if so, what the work 
involves. 


¢ Submit Hiring Request: Generally no rework is needed. 


¢ Approve New Hire Request: Extra work that is required for the General Manager to record a 
rejection reason. 


¢ Approve Hire Request: Extra team work that the HR Administrator and the Hiring Manager 
require. 


¢ Complete Hire Request: Generally no rework is needed. 


Because more than one team is involved in the Approve Hire Request activity, it is no longer a 
“task” but a linked process. The linked process has lanes, such as System, HR Administrator, and 
Hiring Manager. Activities include Check Hire Request, Override Hire Request, and Negotiate Hire 
Request. 


There are two ways to implement a nested process. If the process is not to be reused, the use of a 
subprocess is appropriate. The subprocess is part of the parent process and shares all data. This is 
done if the process is becoming too large and complex. A subprocess cannot be shared. However, 
a linked process is a completely separate process that can be shared. You must determine whether 
you want to use a subprocess or linked process. Because Approve Hire Request might be reused 
in other HR processes, you create a linked process for this scenario. 


__1. Create a process that is called Approve Hire Request. 


__a. From the process library, hover over Processes category and then click the (+) plus 
sign. 


__b. From the New menu, click Process. 


DESIGNER INSPECTOR 


[¥ Process App Settings v .. @ Last updated 4 hours ago by you 


Environment Variables Sé 


HR Recruitment Processes Overview 


New 


User Interface Blueworks Live Subscription 


Processes 


__c. Enter Approve Hire Request for the Name. 
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d. Click FINISH. 


New Process 


A process captures a set of activities and the data and content to support 
the activities. These activities can be part of a structured flow, ad-hoc 
activities that are not part of a structured flow, or a combination of the two. 


Name: Approve Hire Request 


__ 2. Create the System, HR Administrator, and Hiring Manager lanes. 


__a. Click the Lane icon from the palette and drag one lane from the palette to the canvas 
above the default Team lane. 


__b. Inthe General > Common section for the new Team1 lane, change the name to: 
Hiring Manager 
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__c. Rename the second lane to: HR Administrator 


o 
f=) 
o 
= 
o 
= 
Da 
£ 
= 


5¢ 
Inline User 


> ‘Task 


__ 3. Create the Check Hire Request, Override Hire Request, and Negotiate Hire Request 
activities. 


__a. Rename the Inline User Task activity to: Negotiate Hire Request 


General 


| 
Implementation Y Common 
Data Mapping Name: Negotiate Hire Request 


Assignments Color. ewve0T00N" BF 
ID: e45d7 112-25e3-4551-b0ai- 
Pre & Post 334c2ae2234c 
Conditions = = | SE 
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__b. Delete all the flows on the canvas. 


@ Negotiate Hire or 
Create Control point 
Cut 
Copy 
Paste 


Start 


HR Administrator 


c. Expand the activity icon in the palette by clicking the down arrow and drag a User Task 
to the right of Negotiate Hire Request on the canvas. 


Negotiate Hire 
Request 


__d. Name the activity Override Hire Request. 
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__e. Move the Negotiate Hire Request activity to the Hiring Manager lane. 


Ee 


Negotiate Hire 
Request 


Hiring Manager 


3S 
E 
a 
£ 
£ Request 
=] 
zt 
fad 
ae 


f. While Negotiate Hire Request is selected, change the activity to a User Task in the 
Implementation > Activity Type panel. 


__g. Inthe Implementation section, change the implementation to Default Ul Human 
Service. 


General 


Implementation Y Activity Type 


i Type: User Task 


Assignments 


Pre & Post Y Implementation 
Tracking 
Implementation: | a Default Ul Human Service }/JI Toolkit 
Conditions 


< 
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__h. Drag another User Task to the System lane and name the system task: Check Hire 
Request. The selection that you chose last becomes the default for each artifact in the 
palette. To drag the User Task now, you don’t need to select the down arrow since it now 
defaults to the User Task selection. 


‘= 


i. Inthe Implementation section for the Check Hire Request activity, verify that the 
implementation is set to Default UI Human Service. 


General 
Implementation Y Activity Type 
Data Mappin : - 
ee Type: User Task v 
Assignments 


Pre & Post Y Implementation 


Tracking 
Implementation: & Default Ul Human Service } JI Toolkit 
Conditions 
< 
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__j. | The locations of your activities should match the screen capture below. 


| 

o 

= & 
s Negotiate Hire 

= Request 
= 
= = 

- 3 

o 

3 e Override Hire O 
= Request 

3 Start | End 
jaa 

x= 


‘ 


“Check Hire 
Request 
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__k. Move your Start event before the first activity, Check Hire Request in the System lane, 
and the End event after the Negotiate Hire Request activity in the Hiring Manager lane. 
Arrange the activities in an upward diagonal line. 


9 

o 

= ey 

= Negotiate Hire O 
= Request 
= End 
qe 

oS 

fa 

= “Override Hire 

£ Request 

Te 

{ 

aa 

Te 

§ ©) ~ Check Hire 

— Request 

“ Start 


Although the layout breaks the preferred left-to-right, top-to-bottom approach because the process 
starts in the system lane, most developers keep the system lane as the bottom lane. 
Communicating a clear, concise model is the most important goal, and even though this model 
breaks the preferred practice, it meets the readability goal. 


__|. Create a sequence flow from the Start event to Check Hire Request. 
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__m. Repeat adding sequence flows for the remaining activities. 


. 
> & 
= Negotiate Hire 
id 4 
= Request 0) 
r= End 
Se 


& 
Override Hire 
Request 


HR Administrator 


Check Hire 
Request 


__n. Save your process application. 
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Part 7: Attach the linked process 


__ 1. Add the Approvers lane to the parent process. 


To accommodate a subprocess with multiple lanes, a new lane is added in the parent process to 
encompass the roles depicted in the subprocess. 


__a. Return to the Hiring Request Process by opening the History menu at the top and 
selecting Hiring Request Process. 


=) Approve Hire Request|» | & | 


[% Process App Settings 


“) Hiring Request Process «®) 


V2) Approve Hire Request ®) 


__b. Delete the annotation mentioning the potential sub-process. Remember, annotations 
are temporary placeholders to help in understanding the process. Now that the linked 
process is being implemented, there is no need for the annotation. 


__c. Drag anew lane above the Hiring Manager lane in the diagram and name it: Approvers 


Approvers 


o =) 

= C >» Submit Hiring 
i New Request 
= Start 
a 

& 

= 
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__d._ Right-click the Approvers lane and click Move lane down until it is above the System 
lane. 
on 
Create lane above 
Create lane below 


| 
Delete 
Paste - 


__e. Drag the existing Approve Hire Request activity that is in the System lane into the 
Approvers lane. 


¥ 


=) 
Approve New 
Hire Request 


General Manager 


¥ 


A 
Approve Hire 
Request 


wo 
i 
ao 
> 
i) 
— 
2 
2 
x 


a 
>! Complete Hire ~- 
Request 


5 
g End 
me) 


__f. Realign the activities in their respective lanes so that the sequence flow lines are 
straight. 


__g. Save your work. 


___2. Change the implementation of the existing Approve Hire Request activity to a linked 
process. 


__a. With the Approve Hire Request activity selected, open the Implementation menu. 
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__b._ Inthe Activity Type section, select the Type as Linked Process. 


Approve Hire 
Request 


Approvers 


User Task 
Inline User Task 
(45) Robot Task 
System Task 
Decision Task 
: Script 

General je Subprocess 


Implementation (Gq) Linked Process 
= Type: @ User Task iM 
Assignments 


__c. Under the Implementation section, click Select next to Implementation. 


General 
Implementation v _ Activity Type Ik 
Data Mappin : 
pping Type: —_= Linked Process kad 
Pre & Post 


Tracking Y Implementation 


Conditions 
Implementation: <none> New... | 


Dynamic process: & 


© Copyright IBM Corp. 2019 2-35 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 2. Playback 0: Creating the To-Be process 


__d. Select Approve Hire Request from the Process menu. 
Select Library Item 


Business Process Definition °o 


¢{2 Send SLA Violation Email System Data 


Process 


Approve Hire Request 


Hiring Request Process 


___e. The process now shows Approve Hire Request as a linked process. 


General 
| Implementation Def Activity Type 
Data Mapping © : 
5 _ —) Linked Process v 
Pre & Post 
Tracking Vv Implementation 
Conditions 
Called process: @)Approve Hire Request 
Dynamic process: @ & 
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f. The Approve Hire Request activity is now changed to a linked process. In Business 
Process Model and Notation, this is denoted with a plus-sign. 


Approve Hire... 


ay 


Complete Hire ' © 
Request 
End 
___g. Save your process application. 
You have completed this exercise. 
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Part 8: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a._ Inthe Process Apps tab, click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__c. Enter Exercise 2 solution for the name. 
__d. Click Create. 


__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
You can only export snapshots. 


__a. Click Export next to the snapshot. 


__b._ Inthe Export Process App window, click Export. It may take a minute or two to 
generate the . twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

( IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated + w Favorites | Archived 


h. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


In this exercise, you modeled the parent and linked processes in the Workflow Center 
for the HR Recruitment Processes solution. First, you converted business process 
workflow steps that are documented in the process discovery and analysis into process 
model tasks. Then, you defined and modeled team lanes in the business process and 
assigned the tasks to the appropriate teams. Finally, you created a subprocess and 
linked it to the parent process. The next step is to add gateways to direct the process. 
This is covered in the next exercise. 


End of exercise 
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Exercise 3. Playback 0: Controlling 
process flow 


Estimated time 


01:30 


Overview 


This exercise covers how to create gateways in a business process, and how to create timer 
intermediate events. Validation is accomplished through a review session with all business 
stakeholders, business users, and the BPM development team. This unit describes the Playback 0 
validation goals and requirements, explains how to validate that a process model meets the goals 
and requirements, and describes how to reach consensus on the process model. At the end of this 
exercise, you complete Playback 0. 


Objectives 


After completing this exercise, you should be able to: 
e Add gateways to a process 
¢ Model the appropriate sequence flows for each gateway 
¢ Add a timer intermediate event to a process based on business requirements 
¢ Model an escalation path in a process with IBM Process Designer 
¢ Add anew swimlane and activity for legal review to meet additional requirements. 


¢ Validate the process application and create a snapshot 


Introduction 


The purpose of this exercise is to add all the gateways necessary to model the flow control for the 
process. 


In this exercise, you add a timer intermediate event that helps satisfy newly identified requirements 
for the Hiring Requisition process. You are also provided new requirements regarding a legal 
review. After developing from the new requirements, you validate the process application and 
create a snapshot. 


Throughout the exercise, you switch back and forth several times between the Hiring Request Process and 
Approve Hire Request processes. Take additional care when working through the lab to make sure that you 
work in the right process. 


This exercise is long, so a break is included in the middle of the instructions. 
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Requirements 


Successful completion of exercise 1 because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 2 process application solution that is required to start 
exercise 3. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 
__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise _2_solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Create gateways for parent process 


A gateway is represented as a diamond, and can be thought of as a question at a point in the 
process flow. 


Gateways are added to the parent process, the Hiring Request Process. In this part of the exercise, 
you create a gateway that is called Is Position New. 


In the Hiring Request Process, you need a gateway to direct the process for the General Manager 
to review the salary after the Submit Hiring Request activity. 


__1. Create the Is Position New gateway 


__a. Open the HR Recruitment Process (HRR) process application. 


Process Apps Toolkits Servers | Preferences | Logout 


Sort By: Recently Updated ¥ All | W Favorites | A 


ef HR Recruitment Process (HRR) 7 = : : 
% Open in Designer 
_Last updated on 2/21/19 by authort = 


b. Open the Hiring Request Process. 


c. Inthe Hiring Request Process, drag an Exclusive Gateway from the palette onto the 
canvas to the right of the Submit Hiring Request activity. You do not need to open the 
menu to drag an exclusive gateway to the canvas, as the exclusive gateway is the 


default. 
Overview Definition Variables Folders Views Tracking 
r A 

S A 
a a Submit Hiring : | 
fe \ea/ oi Request Ss LC! 
= Start SPT f at 
= xclusive 
= Gateway 
os 

Pes 

| 

uy 
i ce 
oa 
o v 
: Q 

cy) 
= Approve New 
= Hire Request linea 
@ 
© 
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__d. Select the gateway and in the General > Common section below, enter Is Position 
New as the Name. Because exclusive gateways imply a question, the question mark is 


unnecessary, and anyone who views the process automatically assumes the question 
mark. 


General 


Decision v Common 
Implementation — 
Name: Is Position New 
Pre & Post 


Documentation: 
Tracking 


Ill 'e 
I 


wre 
it 


__e. Inthe General > Behavior section, verify that the Gateway type is: Exclusive 
Gateway. 


fy ehavor OI 


Gateway type: 


__ 2. Add sequence flows to connect the gateway. 


__a. Select the sequence flow between Submit Hiring Request and Approve Hew Hire 
Request. 


__b. While selected, right-click the sequence flow and click Delete. 


MQ 


ty) 
Submit Hiring 
Pp , 
Request 
Is Position 
—W 
X Delete 

Create control point 
Cut 
Copy 
Paste 


S2 


a 
Approve New 
Hire Request 
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__c. Create a sequence flow between the Submit Hiring Request activity and the Is 


Position New gateway. Hover over the right anchor point on the activity until an arrow 


appears, then drag the arrow to the left anchor point on the gateway. 


Overview Definition Variables Folders Views 


A 
» Submit Hiring 
Request 


Is Position New 


d. Delete the sequence flow between Approve New Hire Request and Approve Hire 
Request. 


2 


a) 
Approve New 
Hire Request 


_ 


XX Delete —— 


Create control point 
Cut 
Copy 


Paste 
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e. Connect the Is Position New gateway to the top of Approve New Hire Request. 


a 
@ » Submit Hiring 
Request 


Start Is Position New 


To Approve New Hire Request 


fa 
Approve Nev 
Hire Request 


f. Lasso the Is Position New gateway and the Approve New Hire Request nodes. 


~ omit Hiri 
ubmit Hiring 
e > Request os 
Start Is Position New 
To Approve New Hire Request 
Approve New 
Hire Request 
—e 
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__g. Although the sequence flow is highlighted, Process Designer will only align the nodes. 
After highlighting the nodes (depicted by yellow halo), right-click the mouse on one of 
the nodes to bring up the Align nodes menu. Select Center from the Align nodes menu. 


Is Position 
New 


= TOApprove New Hire Request 


gue ce es Ca Ca 
nibs re Align nodes > Top 
Hire Request Rename Middle 
Zim nmiinmt in, && Delete Bottom 
Cut a Left 
Copy la Center 
L Paste it Right 
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__h. Connect the Is Position New gateway to the top of Approve Hire Request. 


fe) ~ 
Submit Hiring >< 
Request 


¢ 
Is Posijon New 


pe Hil: Res 
To Approve Nijw Hire Request To Approve Hil}: Request 


e) 
Appro'/> New 
Hire R| quest 


Approve Hire... 


rd) Note 


Your sequence flows do not have to exactly match the exercise diagrams in this lab. The sequence 
flows change after implementation of the gateways. The flows become default or conditional 
(represented by a diagonal hash marker) according to the order you draw them, so your flows might 
vary from the diagrams in the labs. You learn how to set the default flow in a later exercise. 
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Exercise 3. Playback 0: Controlling process flow 


___ 3. Label the sequence flows. 
Select the flow between the Is Position New gateway and Approve New Hire 
Request. 


__a. 


& 
» Submit Hiring 
Request 


ls Position New 


To Approve Hire Request 


To Approve New Hire Request 


ro 
Approve New 
Hire Request 


b. Inthe General > Common section, enter Review Needed as the Name and verify 
Name visible is selected. 


General 
Implementation Y Common 


Name: Review Needed 

Name visible: 

ID: fc7c0b11-73f9-4fb9-82bb- 
6d4176a56d5f 

Documentation: BIU | =- == 
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Exercise 3. Playback 0: Controlling process flow 


The flow displays the label. 


a 
> Submit Hiring 
Request 


Is Position New 


' : 
Review Needed To Approve Hire Request 
a 


ca 
Approve New 
Hire Request 


__c. Select the flow between the Is Position New gateway and Approve Hire Request. 


__d. Inthe General > Common section, enter Review Not Needed as the Name and verify 


Name visible is selected. 


General 
Implementation Y Common kK 


Name: Review Not Needed| 

Name visible: 

ID: 350afo3f-e5c8-4807-8064- 
a7185955c1b2 

Documentation: BIU | =- == 
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Exercise 3. Playback 0: Controlling process flow 


__@. Save your changes. The flow displays the label. 


A a 

rs Submit Hiring 

= wo * Request ° an 
is Start Is Pdsition 
T= New 


Review Needed 


Review Not Needed 


rT = 

= Q 

c ca 

a Approve New 

= Hire Request 

o 

omg 

a 

oO 

wo Approve Hire... 
a 

) a 
f= © 

iw 

ft 


__ 4. Create the Is Request Approved gateway 


__a. Drag a Gateway from the palette onto the canvas to the left of the Approve Hire 
Request activity. 
Q 


a) 
Approve New 
Hire Request 


s Approve Hire... 


xclusive 
Gateway 
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Exercise 3. Playback 0: Controlling process flow 


__b. Select the Exclusive Gateway and in the General > Common section, enter Is 
Request Approved as the Name. 


General 


rhociaian v Common 
Implementation Name: Is Request Approved 


Pre & Post ID: f2330684-23f7-4361-842f- 
f5191a398bc3 
Tracking : 
Documentation: BIU | =- = 
SESE le 


__c. Inthe General > Behavior section, verify Exclusive Gateway as the Gateway type. 


Gateway type: 


5. Connect and label the sequence flows. 


__a. Connect the Approve New Hire Request to the top of the Is Request Approved 


gateway. 
a) 
Approve New 
Hire Request 
Approve Hire... 
Approved 
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Exercise 3. Playback 0: Controlling process flow 


__b. Connect the Is Request Approved gateway to the left anchor point of Approve Hire 
Request. 


q To Approve Hire Request —D| Approve Hire... 


Is Request 
Approved 


Connect the Is Request Approved gateway to the Complete Hire Request activity. 


&. To Approve Hire Request 


_ 


Approve Hire... 


¥ 


fas) 
Complete Hire 


To Complete Hire Request > Request 


__d. Select the flow between the Is Request Approved gateway and the Approve Hire 
Request linked process. 
__e. Rename the default name to Approved and verify Name visible is selected. 


General 
Implementation Y Common 


Name: Approved 

Name visible: 

ID: 28880616-ad27-4225-87fe- 
432678905498 

Documentation: BIU | =S- == 
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Exercise 3. Playback 0: Controlling process flow 


__f. Select the flow between the Is Request Approved gateway and Complete Hire 


Request. 
__g. Rename the default name to Not Approved and verify Name visible is selected. 


General 
implementation YY Common l 


Name: Not Approved| 
Name visible: 
ID: 02a3f7 1c-2962-4b09-8148- 
fic95da28541 
Documentation: BIu|/==e= 
The flow displays the label: 
- Approved Approve Hire... 
Is Request 
Approved 
¥ 
—_ 
Complete Hire 
Request 


Not 4 ed > 
End 


__h. Save your process. 


__ 6. Verify the process model 
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Exercise 3. Playback 0: Controlling process flow 


If you have a colleague or others nearby, see whether you can explain your new model to them to 
simulate a playback. Being able to clearly communicate the process is key when implementing 
business process management. 


__a. Use the zoom slider at the upper right to view the whole process if it doesn’t fit on the 


screen. 
CREATE NEW (+) ®) 
[4] 
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Exercise 3. Playback 0: Controlling process flow 


__b. Ensure that the Hiring Request Process process looks similar to the screen capture 
before moving on: 


‘= 
o 
fa] 
Bs ssid 
2 @ — > 
= 
2 Is Position 
r= 
ac 
Review Not Needed 

Review Needed 
5 a 
z a 
& Approve New 
= Hire Request 
5 | 
o 
oO 
be on Approved 
o 
> 
4 Is Request 
z Approved 

¥ 
fay 
Wet fescennd ». Complete Hire 
End 
He 
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Exercise 3. Playback 0: Controlling process flow 


Part 3: Create gateways for the linked process 


Add gateways to the nested process Approve Hire Request. 
__1. Create the Is Salary Compliant gateway. 


__a. Click Processes in the library and click Approve Hire Request from the menu. 


“2 Approve Hire Request - ® @ ko Changes saved... 


@ Processes 


HR Recruitment Proc 


@ Process 
3] Approve Hire Request 


User Interface 3] Hiring Request Process 


__b. Drag a Gateway from the palette onto the canvas to the right of the Check Hire 
Request activity. 


a 
= - 
2 & = 
o Negotiate Hire ~O ¥ 
= Request 
= End Or 
2 ji >) 
¥ 
a 
5 QO 
& — 
ic Override Hire lida) 
£ Request 
tt 
oa 
= & 
2 
E yO _Checkibita 
o \ew’/ if Request Ss 
o i H 
Start Exclusive 
Gateway 
__c. Rename the gateway to: Is Salary Compliant 
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Exercise 3. Playback 0: Controlling process flow 


__d. Verify that the Gateway type is Exclusive Gateway. 


2. Connect and label sequence flows. 


__a. 
__b. 


_ Cc. 


Select the sequence flow between Check Hire Request and Override Hire Request. 


Hover over the tip of the sequence flow to see a blue point. 


~ Override Hire 
Request 


~ Check Hire 


’ f 
WY > Request ’ 


Start Is Salary 
Compliant 


Select the blue point and drag the flow to connect Check Hire Request to the Is Salary 
Compliant gateway. 


CS — 
———__—_—_—_—_—_—___—_——__ 
4 Request I> 
Is Salary 
Compliant 


OQ Hint 


You can drag sequence endpoints from one activity to the other. To do this, highlight the endpoint 
until it displays as bright blue. Then, drag the endpoint to another activity and release. 


Approve Hire 
Request 


It can be tricky to highlight the endpoint correctly. As you become familiar with the Process 
Designer tool, you can choose the methods that work best for you. For instance, if it becomes too 
cumbersome to drag sequence lines from one activity to another, you can delete them and rebuild 


them. 
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Exercise 3. Playback 0: Controlling process flow 


__d. Connect Is Salary Compliant to the bottom of Override Hire Request. 
“Override Hire 
Request 
To Overrid|; Hi] 2 Request 
i ~ Check Hire = 
New 4 Request wy 
Start Is Salary 
Compliant 
__e. Remove the existing sequence flow between Negotiate Hire Request and the End 
event by highlighting the flow then pressing the Delete button on the keyboard. 
__f. Move the End event from the top of the diagram and place it to the right of Is Salary 
Compliant. 
To Override Hire Request 
> ~ Check Hire 
Request 
Is Salary 
Compliant 
__g. Connect Is Salary Compliant to the left anchor point of the End event. 
& Zz 
Ss Check Hire 
O42 4 ares 
Start Is Salary End 
Compliant 
__h. Select the flow between the Is Salary Compliant gateway and Override Hire Request. 
__i. Rename the flow: Not Compliant 
__j. Select the flow between the Is Salary Compliant gateway and the End event. 
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Exercise 3. Playback 0: Controlling process flow 


k. In the General > Common section, rename the flow: Compliant 


General 


Implementation Y Common 


Name: Compliant 


Name visible: 
ID: e6363127-08ad-4f31-8ca3- 


|. Verify your process. Your process should look similar to this screen capture. 


c4 
Override Hire 
Request 


Not Compliant 


& x 
a Check Hire —_ : 
a ba Request ~ cane +@ 
Start Is Salary End 
Compliant 


__m. Save your work. 


It is okay if the default sequence flows do not match. These are implemented later. 


© Copyright IBM Corp. 2019 3-21 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 3. Playback 0: Controlling process flow 


__ 3. Create the Is Salary Acceptable gateway. 


__a. Drag a Gateway from the palette onto the canvas to the right of the Override Hire 
Request activity. 


~ Override Hire i Va a 
Request 


Ex 
Gateway 


Not Compliant 
- ~Ch k Hi A 
i ™ eck Hire : 
a, > Request ~~ comesert +© 
Start Is Salary End 
Compliant 


b. Setthe gateway name to: Is Salary Acceptable 


c. Delete the flow between the Override Hire Request and the Negotiate Hire Request 


activities. 
__d. Connect the Override Hire Request to the left anchor of the Is Salary Acceptable 
gateway. 
soetcs a 
Request 
Is Salary 
| Acceptable 
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Exercise 3. Playback 0: Controlling process flow 


__@. Connect the Is Salary Acceptable gateway to the bottom anchor of Negotiate Hire 
Request and to the top anchor of the End event. 


a 
Negotiate Hire 
Request 


EN 


To Negotiate Hire Request 


& 
Override Hire >» 
Request 
Is Salar, 
Acceptabl!: To End 
Not Compliant 
4 
~~ Compliant 
Is Salary End 
Compliant 


f. Rename the flow between the Is Salary Acceptable gateway and Negotiate Hire 
Request as: Not Accepted 


__g. Rename the flow between the Is Salary Acceptable gateway and the end event as: 
Accepted 
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Exercise 3. Playback 0: Controlling process flow 


__ 4. Create the Resubmit Salary gateway. 


__a. Drag a Gateway from the palette onto the canvas to the right of the Negotiate Hire 
Request activity. 


ca £ : 
Negotiate Hire 
Request 


Exclusive 
Gateway 


A 


Not Accepted 


a) a 
Override Hire > 
Request 


Is Salary 
Acceptable 


Accepted 


Not Compliant 


4 
>< > Compliant O 
Is Salary End 
Compliant 


b. Rename the gateway to Resubmit Salary and verify that the Gateway type is 
Exclusive Gateway. 


c. Drag an End event from the palette onto the canvas to the right of the Resubmit Salary 
gateway. 


# 


fe st 
Negotiate Hire © e@ 
Request 


Resubmit End Event 
a Salary 


Not Accepted 


__d. Rename the End event as: End Cancel 
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Exercise 3. Playback 0: Controlling process flow 


__e. Connect Negotiate Hire Request to the Resubmit Salary gateway. 
__f. Connect the Resubmit Salary gateway to the End Cancel event. 


__g. Connect the Resubmit Salary gateway to the top of Override Hire Request. 


To Override Hire Request 


Negotiate Hire . 
Request > To End Event C) 
Resubmit End Cancel 
‘ Salary 


wride Hire an 
‘equest 


Is Salary 


A 


__h._ To fix the flow that overlaps the Negotiate Hire Request activity, select the To Override 
Hire Request flow and right-click the flow. Click Create control point. 


To Ove oe 
xX Delete 
Create control point ire <o 
Cut i; 
Resubm 
Copy Salary 
Paste 


You use control points to manipulate the sequence flow path between two connection 
points. This helps to make the diagram more readable. 
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Exercise 3. Playback 0: Controlling process flow 


__i. Drag the blue diamond to move the flow above the activity. 


| 
| 


é4 
Negotiate Hire >. x 
Request 


Resubmit 
Salary 


fa 
Override Hire > 
Request 
Is Salary 
A Acrcantohio 


__j. Name the flow between the Resubmit Salary gateway and Override Hire Request as 


Resubmitted. 
__k. Label the flow between the Resubmit Salary gateway and the End event as 
Canceled. 
Resubmitted 
4 tiate Hi 
egotiate Hire . 
Request 3 [-eancsted-]4Q) 
Resubmit End Cancel 
4 Salary 


: ¥ 
a 4 
Override Hire 2 
Request 
Is Salary 
| Acceptable 


__|. Straighten the sequence flows as necessary. 


__m. Save your work. 
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Exercise 3. Playback 0: Controlling process flow 


ee Optional 


You completed part 2 of the 5, so you are now approximately half done with this exercise. Now 
would be a good time to take a 10-minute break. 
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Exercise 3. Playback 0: Controlling process flow 


Part 4: Modeling timer intermediate events 


Examine the process requirements and determine where an escalation exists. 


Refer to the core requirements for an escalation in section 2.10 that is listed in Exercise 2. The HR 
Administrator has 4 hours to complete the review. If the review is not completed within 4 hours, an 
email is sent to the HR Administrator notifying the HR Administrator of the missed deadline. 


In this part of the exercise, you use the timer implementation option to model an escalation path in 
your processes. Using a timer intermediate event, you can specify a time interval after or before 
which some activity is conducted. The timer implementation option is available for events that are 
included in the process flow and events that are attached to an activity. 


__ 1. Attach a four-hour timer event to the Override Hire Request activity. 


__a. Inthe Approve Hire Request process, select the drop-down icon beside the 
Intermediate event. 


OO 
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Exercise 3. Playback 0: Controlling process flow 


__b. Select the Timer event from the set of intermediate events. 


Not Accepted 


& # 
Override Hire > 
Request 


Is Salary 
Acceptable 


Accepted 


Not Compliant 


__c. Drag the Timer event from the palette onto the lower-left anchor of the Override Hire 
Request activity. 


+1. 


_ 
L Override Hire 4 
Request 


— 


© Important 


lf Boundary Event Type is not displayed and you see Intermediate Event Type in its place, you 
have not successfully anchored the Timer Event to the boundary of the activity. 


General 


Implementation Y _ Intermediate Event Type 
Data Mapping ‘siti 


Sometimes attaching the timer event to the activity can be tricky. Look for the anchor points to 
appear on the activity while the mouse is hovering over the activity, then drag the timer to one of the 
anchor points. You see the green plus if you hover over one of the anchor points. 


For this exercise, make sure that you drag the timer event onto the activity instead of outside of the 
activity. In this case, you want a boundary or attached intermediate event instead of a sequence 
flow intermediate event. If you correctly create an attached timer event, the name for the attached 
intermediate event is also changed to Boundary Event. 


__d. Select the Timer event. 
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Exercise 3. Playback 0: Controlling process flow 


__e. Inthe General > Common section, change the name to: 4 hour timer 


General 


implementation v Common 
Data Mapping Name: 


Pre & Post ID: 9582566b-4a6d-4950-8f21- 
Documentation: BIU | = == 
__f. Select the Implementation menu. In the Boundary Event Type section, make sure that 
the Timer boundary event is selected. Keep the remaining default properties that were 


set during implementation. 


General 


Implementation vY Boundary Event Type 
Data Mapping 
Timer 
Pre & Post 


Interrupt activity: 


Repeatable 


Vv Event Properties 


Trigger on: After start of step 
Custom date 

Before or after difference: 0 

Tolerance interval: 0 


Use the activity work schedule: @ LJ 
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Exercise 3. Playback 0: Controlling process flow 


__ 2. Add the Notify HR Administrator activity. 


Resize the System lane. To do this, click and hold the left mouse button down, then 


__a. 
drag the mouse outside of the lane to increase the height of the lane. 


~ la ‘| ~ Check Hire 
Bo \ees/ Request 
oo Start 


b. Drag a box around the activities, events, and the gateway in the System lane (lasso), 
and move them down together to make space for this new activity. Once items are 
highlighted, you can also use the arrow keys on the keyboard to move them. 


Expand the Activity icon in the palette and drag User Task from the palette to the 


oe 
System lane. Place it above the Check Hire Request activity. 
User Task Not Compliant 
c & Z 
$ [a ia Check Hire Compliant ‘O 
~ wy Request 
* Start ie Salary End 


Compliant 


__d. Rename the activity to: Notify HR Administrator 
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Exercise 3. Playback 0: Controlling process flow 


e. Connect the Timer Intermediate Event to the Notify HR Administrator activity. 
¥ 
Q 
a 
Override Hire 
Request 


Not Compliant 


Notify HR 
Administrator 


__f. With the sequence line highlighted, name the flow 4 Hours and select Name visible in 
the General > Common properties section. 


General 
Implementation Y Common 


Name: 4 Hours 

Name visible: 

ID: bedd607b-1d7f-4086-8f2d- 
469f148dfe8c 


__ 3. Add an End Notification event. 
Drag an End Event from the palette onto the canvas to the right of Notify HR 
Administrator. 


a. 
_¥ 
fe. 
Override Hire 


Request 
4 Hours 


A 


Q poe 
= Notify HR i ? Nc] Compliant 


Administrator 2 a ae 
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Exercise 3. Playback 0: Controlling process flow 


b. Rename the End event to: End Notification 


General 


implementation v Common 
Data Mappin 
csi Name: End Notification 


Pre & Post ; 
Documentation: | ae me (= = 
Tracking 


c. Connect the flow from Notify HR Administrator to End Notification. 


¥ 


§ 


x Not Compliar 
Notify HR » O 
Administrator 


End Notification 


System 


& z 
Check Hire : O 
OQ * Request ~) en 
Start Is Salary End 
Compliant 


d. Save your work. 
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Resubmitted 

= 
9 4 
s Negotiate Hire 
= Request ~ Sate ~O 
z Resubmit End Event 
z Salary 

Not Accepted 
S 
s Yv 
= ¢ 
2 
= Override Hire > 

Request 

z 4 Hours 
es Is Salary 
ee Acceptable 
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__ 4. Verify the process model 


Exercise 3. Playback 0: Controlling process flow 


__a. Ensure that the Approve Hire Request process looks similar to the diagram before 


moving on: 
o 
an 
o 
£ 
o 
= 
Dn 
£ 
= 
s ¥ 
3 & 
a7] Override Hire _ 
£ Request 
E 
t “ 
x 
BS 
Fs 
Notify HR Not Complisnt 
Administrator 40) 


O 


Start 
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fe 
» CheckHire 
Request 


End Notification 


4 


Is Salary 
Compliant 


Resubmitted 


Negotiate Hire 


Request N= Canceled *O 


Resubmit End Cancel 


4 Salary 


Not Accepted 


Is Salary 
Acceptable 


Accepted 


Compliant O 


End 
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Exercise 3. Playback 0: Controlling process flow 


Part 5: Add new process requirements to the process 


It is common to clarify requirements throughout the playback sessions. During the initial playback, 
the vice president mentions new requirements. 


Several job postings contain wording that violates a new set of hiring laws. To address this issue, 
the vice president suggests that a lawyer must review every job post at some point before the job 
opening is released and posted to the public. The lawyer checks for legal compliance and edits if 
necessary. 


Examine the requirement and come up with the solution for this requirement. 
__ 1. Adda lane in the Hiring Request Process for the legal team. 
__a. Open the Hiring Request Process. 


__b. Drag aLane from the palette to the canvas above the Hiring Manager lane. 


Overview Definition Variables Folders Views Tracking 


: Q 
2 = 
wy 
“yy 
oo, 
\oyW 
D » 
ao 
oO 
= =) 
= | al », Submit Hiring 
m wy Request 
& V4 
= Start Is Position 
New 
Review Not Needed 
Review Needed 
__c. Name the lane: Legal 
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Exercise 3. Playback 0: Controlling process flow 


__d._ Right-click the Legal lane. Click Move lane down. Repeat moving the lane down until 
the Legal lane is between the Approvers and System lanes. 


w 

o an Approved Approve Hire... 

oO 

= Is Request B 
Approved 


whlot Approved... 
v 
one 
omplete Hire 

E ” Request *O 
7) End 
> 

“a 

__ 2. Create an activity for a lawyer to review the hire request. 
__a. Drag User Task from the palette to the Legal lane in the process. 
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Exercise 3. Playback 0: Controlling process flow 


__b. Name the activity: Review Posting 


\—— Approved Approve Hire... 


Is Request 


Approvers 


Review Posting — 


__ 3. Adda gateway to check the compliance of the request. 
__a. Drag a Gateway to the right of Approve Hire Request. 


__b. Rename the gateway to: Is Request Compliant 


© 


Approve Hire... 


Is Request 


z Compliant 
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Exercise 3. Playback 0: Controlling process flow 


__ 4. Connect the Review Posting activity. 


__a. Select the sequence flow between Approve Hire Request and Complete Hire 


Request activities. 
Qo 
\ Approved 
Is Request 


Is Request Compliant 
Approved 


Approve Hire... 


a) 


Review Pasting 


=e Not Approved 


‘Complete Hire 
"T Request 4°) 


End 


__b._ Drag the blue point that appears at the tip of the flow line at the Complete Hire Request 
activity to the Is Request Compliant gateway. 


Approve Hire... p> [<> 


a Is Request 
Compliant 
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Exercise 3. Playback 0: Controlling process flow 


__c. Connect the Is Request Compliant gateway to Complete Hire Request. 


Approve Hire... 


a Is I) e yuest 
Cc|nodliant 


To Compl |te Hire Requelt 


Q 


ca 
Complete Hire 
" Request ~O 


__d. Drag the Review Posting activity above the Complete Hire Request activity. 
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Exercise 3. Playback 0: Controlling process flow 


__e. Connect the Is Request Compliant gateway to the Review Posting activity. 


Approve Hire... ~<O 


2) Is Re ast To Review | Posting 


es 
To Complete Hire Request Review 
Posting 
Le 
Complete Hire — n@) 
Request 
7 End 
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Exercise 3. Playback 0: Controlling process flow 


__f. Create a flow from Review Posting to Complete Hire Request. 


Approve Hire... , xo 


2) Is Request To Review Posting 
Compliant 


¥ 


Review 
Posting 
To Complete Hire Request 


> (2 
Complete Hire ~- 
Request 


End 


__g. Rename the sequence flow between Is Request Compliant and Complete Hire 
Request as: Request Canceled 


h. Rename the sequence flow between Is Request Compliant and Review Posting as: 
Request Compliant 


i. Save your work. 
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Exercise 3. Playback 0: Controlling process flow 


__ 5. Verify the process model 


__a. Ensure that the new process looks similar to the diagram before moving on: 


D 
faz] 
o 
= = ao 
= | a > Submit Hiring 
> WS Request 
= 4 
= Start Is Position 
i 
New 


Review Needed Review Not Needed 


o | 

= ¥ 

& 

cy 

= Approve New 

= Hire Request 

oa 

= 

oa 

oO 

fe 

2 \ Approved Approve Hire... <o 

o 

= PA 

& Is Request 2 ls Request Request Compliant 

Approved Compliant 
¥ 

a Cy) 

3 Request Canceled Review 

=] Posting 

| v 
Oo : 
it nord ecenaieltaal of 

5 End 
B 

=> 
oo 


@ Important 


After adding an element to your process, it is a good practice to verify the process a second time. 
When you encounter process problems while developing for the Playback 1 process phase, it is 
common to return to Playback 0 to correct the problems. 


Playback 0 is complete. 
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Part 6: Validate the process model and take a snapshot 


Now that playback 0 is complete, it is a good time to validate the process application and take a 
snapshot. 


__1. Validate the process application. 


While you are developing, Process Designer keeps track of any validation errors and displays the 
number of errors in the status bar at the bottom. 


__a. Review the status bar validation icon for any errors. 


__b._ If you have validation errors, you should resolve them before moving onto the next 


playback. As you add coaches and services, this functionality becomes more important. 
For now, there should be no validation errors for the processes. 


__2. Take a snapshot. 


A snapshot captures the state of the library items within a process application at a specific 
point in time. Snapshots usually represent a milestone or are used for playbacks or for 
installation. 


__a. Click the camera icon in the upper right corner and select Create a new snapshot. 


Create anew snapshot 
View existing snapshots 
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__b. Enter Playback @as the name and click FINISH. 


Take Snapshot 


Take a snapshotto capture the current process application. 


Name} |Playback 0 


Description: 


___c. Click OK when the snapshot is created. 


You have completed this exercise. 
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Part 7: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__1. Create a snapshot 
__a._ Inthe Process Apps tab, click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


$ Open in Designer 


__c. Enter Exercise 3 solution for the name. 
__d. Click Create. 

__ 2. Export the application. You can only export snapshots. 
__a. Click Export next to the snapshot. 


__b. Inthe Export Process App window, click Export. next to the Exercise 3 solution. It 
might take a minute or two to generate the .twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 
IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated + w Favorites | Archived 


__h. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


The first part of this exercise involved adding gateways to the process in IBM Process 
Designer. Next, you modeled the appropriate sequence flows for each gateway. Then, 
you added a timer intermediate event for a process requirement. Next, you validated the 
business process, and you took the playback feedback and added a requirement to the 
process. All the stakeholders agreed to the revised version of the process, and the 
process owner along with the lead developer suggested that the team transition to 
Playback 1. 


End of Exercise 
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Exercise 4. Playback 1: Controlling 
process flow with business 
data 


Estimated time 


01:30 


Overview 


In this exercise, you create assets that are required during Playback 1 controlling the process flow 
of the process lifecycle. You create variables, implement timer intermediate events, establish 
routing, and implement exclusive gateways. 


Objectives 


After completing this exercise, you should be able to: 
¢ Create simple variables in a process 
¢ Implement timer intermediate events in a process 
¢ Implement gateways for a process 


¢ Implement routing for an activity 


Introduction 


In this part of Playback 1, the process variables (also known as flow data) are built and 
implemented in the gateways. Flow data is used throughout the life of the process. It is used along 
with gateways to determine the flow of the process based on the values of the flow data. When a 
token is at a gateway, the value of the variable is evaluated to determine the next path to take. Flow 
data also includes the following circumstances: 


¢ Data that is used to determine which activities to run 
¢ Data that is used to determine who starts each activity 
¢ Data that is used to determine when an activity is due or when an activity must be escalated 


The flow data ensures that the business process gets the right activities to the right people at the 
right time. 


Requirements 


Successful completion of exercise 1 because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 3 process application solution that is required to start 
exercise 4. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 
__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise_3_solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Implement the intermediate timer event 


In Playback 0 of the Hiring Request Process, an attached timer intermediate event was modeled. 
The HR Administrator has 4 hours to complete the review. If the review is not completed within 4 
hours, an email is sent to the HR Administrator. The email notifies the HR Administrator of the 
missed deadline. Now your responsibility is to implement the timer event that was modeled. 


__1. Implement the attached timer intermediate event. 
a. Open the HR Recruitment Process (HRR) process application. 
b. Open the Approve Hire Request process and select the Definition tab. 


c. Click the timer intermediate event that is attached to the Override Hire Request 
activity. 


Not Accepted 


Override Hire 


= ol Request 


Is Salary 
Acceptable 


d. Below in the properties section, click Implementation. 


e. Change the Event Properties to the following values: 


- Trigger on: After start of step 
- Before or after difference: 4 Hours 
- Tolerance interval: 0 Hours 


General 
implementation v Boundary Event Type €) 
Data Mapping 
©rTimer v 
Pre & Post 
Interrupt activity: 
Repeatable 
v Event Properties 
Trigger on: After start of step 
Custom date 
Before or after difference: Hours ¥ 
Tolerance interval: ®« | Hours v 


Use the activity work schedule: G@| (1 


__f. Save your work. 
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Part 3: Create the process flow variables for the Hiring Request Process 


The process model for the Hiring Request Process is in place. Data flow implementation is one of 
the goals of Playback 1. Now you must start to implement the process, first by creating simple 
variables to implement the logic behind the decision gateways on the current process. 


__ 1. Create a private variable to control the Is Position New exclusive gateway. 


Overview Definition Variables Folders Views 


fe 


> Submit Hiring 
Request 


Is Posifon New 


Review Needed 


__a. Open the Hiring Request Process. 


__b. Click the Variables tab. 


Overview _ Definition Folders Views 


__c. Click the (+) plus sign next to Private. 


Overview Definition Variables Folders Views 


~~» Input @) y 
@ Output G4) 

@ Private . 
2 Exposed Process Variables 
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__d. Name the private variable: isNewPosition 
Confirm that the Variable Type is String. 


Vv Details 


Documentation: BIU | =a se ele | 
Variable type: @ String System Data] Select... | New... 
List C] 
Visible in Process Portal: ia 


String variables are used here instead of Boolean for flexibility of the implementation. If 
requirements change later, and a third outflow is added to the gateway, a String is easier 
to implement the change than a Boolean would be. 


e. Inthe Documentation field, insert the following text: 


© = Not a new position 
1 = New position, requires approval 


isNewPosition 


Name: 


ny 
| 
tl 


Documentation: a a | a 


b= G 
0 = Not a new position 
1 = New position, requires approval 


__f. Donot change the other options. Save your changes. 
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__2. Create a variable to control the Is Request Approved exclusive gateway. 


\— |]— Approved Approve Hire... 


Is Request i) Is Réhuest 
Approved Compliant 


a. On the Variables tab, create another Private variable: isApproved (String) 
b. Inthe Documentation field, insert the following text: 


© = Not approved 


1 = Approved 

Vv Details 

Name: isApproved 

Documentation: — ee | 
0 = Not approved 
1 = Approved 

Variable type: P String System Data | Select... New... 

List: LJ 
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__ 3. Create a variable to control the Is Request Compliant exclusive gateway. 


Approve Hire... —>— 


ic) Is Réhuest 
Compliant 


Approved 


a. On the Variables tab, create another Private variable: isCompliant (String) 


The isCompliant process flow variable maps to a variable in the Approve Hire 
Request linked process. 


b. Inthe Documentation field, insert the following text: 


© = Hire request is canceled 
1 = Hire request is compliant 


Name: isCompliant 
Documentation: os | 
0 =Hire requestis canceled 
1 =Hire request is compliant 
Variable type: QP String System Data | Select... | New... 
List LJ 


__c. Save your changes. 
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You created three private variables in this exercise. 


Vv Variables 


~® Input 


©! + 
© Output @ 
vy @ Private @ i 
@ isNewPosition (String) L 
@ isApproved (String) 
@ isCompliant (String) 
a Exposed Process Variables @ 
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Part 4: Create process flow variables for the Approve Hire Request linked 
process 


__ 1. Create a variable for the Is Salary Compliant exclusive gateway in the Approve Hire 
Request process. Because the parent process uses this data, create a variable that passes 
data through the linked process as an input and output variable. 


__a. Return to the Hiring Request Process model by clicking the Definition tab. 


Overview Variables Folders Views 


__b. Open the Approve Hire Request linked process by double-clicking the linked process 
in the diagram. 


on Approved ————| Approve Hire... — ~O — 


4 
Is Request 2) Is Request 
Approved Compliant 


Be sure that you select the Approve Hire Request linked process, not the Approve 
New Hire Request activity. Look for the linked process marker on the bottom center. 


c. Click the Variables tab for the Approve Hire Request linked process. 


d. Click the (+) plus sign next to Input. 


a] 


™@ Output () 
@ Private @ 
2 Exposed Process Variables @ 


__e. Name the input variable: isCompliant 
Verify that the Variable Type is String. 
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Insert the following text in the Documentation field: 


0 
1 


Salary is not compliant 
Salary is compliant 


Name: isCompliant 


Documentation: 


0 = Salary is not compliant 
1 = Salary is compliant 


Variable type: ® String system Data} Select. | 


List L| 
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Create an output variable: isCompliant (String) 
h. Insert the following text in the Documentation field: 


0 
1 


Salary is not compliant 
Salary is compliant 


Name: isCompliant 
Documentation: = | = = | 
0 = Salary is not compliant 
1 = Salary is compliant 
Variable type: 3 String System Data} Select... New... 
List: LJ 


__i. Save your work. 


Vv Variables 


vy @ Input @ nN 
® isCompliant (String) 
vy & Output @ * 
 isCompliant (String) L 
@ Private ‘o) 
2 Exposed Process Variables ‘o) 
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___2. Map the process flow variable to the Approve Hire Request linked process. 


__a. Return to the Hiring Request Process by opening the History menu at the top and 
selecting Hiring Request Process. 


DESIGNER INSPECTOR 


[¥ Process App Settings| v | 
[% Process App Settings 


=) Hiring Request Process «®) 


__a. On the Hiring Request Process, click the Approve Hire Request linked process. 


Approve Hire... ~~» 


Is Request i) Is Request 
Approved Compliant 


__b. Click the Data Mapping menu. 
__c. Click the auto-map icon on both the Input Mapping and Output Mapping sections. 


tw.local.isCompliant & > isComplian... isCompli..  — fwlocal.isCompliant & 


Because the variables being mapped use the same name and variable type, the 
auto-mapping feature is appropriate to be used here. This feature is especially helpful 
when there are many variables being mapped with the same names and types. 


d. Save your work. 


When you run the process, the value of the isCompliant variable is passed in and out of 
the Approve Hire Request linked process. Any changes to the variable while the 
Approve Hire Request process runs will be reflected when the isCompliant variable is 
passed back to the parent process. 
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Part 5: Implement gateways 


When you modeled the process during Playback 0, you added several gateways to the process. 
Now you must implement these gateways. In this section, you enhance the process by 
implementing the exclusive gateways in both the Hiring Request Process and the linked process. 
You use the simple variables that were created in the previous sections to implement the gateways. 


You implement the exclusive gateways in the Hiring Request Process process and the Approve 
Hire Request linked process to meet the following requirements: 


e Ifthe request is for a new position, the request is forwarded to the General Manager. After the 
General Manager receives the request, the General Manager approves or rejects the request. 


¢ If the request is rejected, the system processes the request and the Hiring Request process is 
complete. If the request is approved, the process flows to the Approve Hire Request linked 
process. 


¢ Inthe linked process, after the requisition is submitted, an automated system-level check for 
salary compliance starts. If the request meets salary compliance, the hiring request is 
forwarded to Legal for review. If the request is canceled, it is automatically sent to the HR 
Positions database and processed. 


__1. Implement the Is Position New exclusive gateway. 


When the position is new, the process must flow to the Approve New Hire Request activity 
down the Review Needed flow. 


__a._ Inthe Hiring Request Process diagram, click the Is Position New exclusive gateway. 
Note where the default gateway is. This changes when you implement the gateway in a 
later in the exercise. 


2 
Submit Hiring 
Request 


New 


Review Needed 


ce ad ttt 


__b. Open the Properties > Implementation menu. 


General 


Decision Vv Decisions 


Implementation 


Review Not Needed: @ & NONE v & 
Pre & Post Default flow: Review Needed v 
Tracking 
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@ Information 


You see a red “x” @ next to the field while the decision is being configured. It clears when the 
decision is defined. 


__c._ Inthe Decisions section, click the arrow to expand the Default flow selection box. 


General 
Implementation j ; : 
Review Not Needed: @ & NONE v & 
tes de Default flow: Review Needed 
Tracking ‘Review Needed 


| Review Not Needed 


__d. Select Review Not Needed. 


General 


Decision Vv Decisions 


Implementation 
: Review Needed: @ & NONE v & 


Fre Shee Default flow: Review Not Needed v| 


Tracking 


__e. Verify that the default flow is now changed for the Is Position New gateway. 


e 3 | 
oc ( > » Submit Hiring 
= |} Request 
DO | 
= Start | | Is Position 
ae New 
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__f. Inthe first field to the right of the Review Needed label, click the Variable Picker icon. 


General 


Decision Vv. Decisions 


Implementation ; : : 
Review Needed: @ NONE v & 


Pre & Post Default flow: Review Not Needed he 


Tracking 


__g. Select isNewPosition (String). The field is populated with the variable: 
tw. local.isNewPosition 


General 


Implementation - — 
Review Needed: tw.local.isNewPosition e NONE »v 


Pees Default flow: Review Not Needed 
Tracking 


@) Hint 


You can also type this variable and as you type and press Ctrl+Spacebar, the auto-complete feature 
suggests different options to you that match what you already typed. The options are filtered as you 
complete your entry. 


Y Decisions 


Review Needed: tw.local]| 

@ isApproved - String 

@ isCompliant- String 
@ isNewPosition - String 


Default flow: Review 


The auto-complete window provides other contextual information on the object or object type. Use 
the mouse or the up and down arrows on the keyboard to select the correct option, and press Enter 
to select the option. 


__h. Next, change the evaluation value to: == 
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__i. In the last field to the right of Review Needed, enter the value: "1" 


Vv Decisions 


Review Needed: twlocal.isNewPosition & | == 


Default flow: Review Not Needed ¥ 


The condition is set for the Is Position New gateway. If the first condition is not met, the default 
condition is Review Not Needed. 


@ Important 


Once the gateway is implemented, the conditional flow is flagged with a diamond at the point at 


which it exits the gateway. 
: ze 


___2. Implement the Is Request Approved exclusive gateway. 


When the request is approved, the process must flow to the Approve Hire Request linked 
process down the Approved flow. 


__a. Click the Is Request Approved exclusive gateway on the process. 


Approved Approve Hire... 


__b. Inthe Properties pane, open the Implementation menu. 


General 


Decision v Decisions 


Implementation 
[_iotementation Not Approved: @ & NONE v & 


Pre & Post 
Default flow: Approved KA 


Tracking 


__c. Inthe Decisions section, expand the Default flow selector. 
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d. Select Not Approved. This selection makes Not Approved the default sequence flow. 
The order of sequence flow starts with Approved at the top and Not Approved on the 
bottom. 


General 


Decision v Decisions 


Approved: @ & |NONE v & 


Pre & Post 
Default flow: Not Approved v 


Tracking 


e. Inthe first field to the right of Approved, select the following using the variable picker: 
tw. local. isApproved 


f. Next, change the evaluation value to: == 


__g. Inthe last field, enter the value: "1" 


General 
Decision v Decisions 
Implementation 
twilocalisApproved & == R 
Pre & Post 
Default flow: Not Approved v 
Tracking 


Implement the Is Request Compliant exclusive gateway. 


When the request is compliant, the process must flow to the Review Posting activity down 
the Request Compliant flow. 


The conditions for this gateway are set in a decision service in Playback 2. All the conditions 
that must be met are established as a business rule. The intent for this playback is merely to 
control the flow. For now, focus on implementing the gateway, not how the data is 
generated. 


__a. Click the Is Request Compliant gateway on the process. 


Approved Approve Hire... > 
BF PP Request Compliant 


i) Is Request 
Compliant 
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__b. Click the Implementation menu. 


General 


Decision v Decisions 
Implementation 
[rnementaton Request Compliant @ & NONE v & 


Pre & Post 
Default flaw: Request Canceled 


[<] 


Tracking 


c. Inthe Implementation section, expand the Default flow selector. 


d. Select Request Compliant. This arrangement makes Request Compliant the default 
sequence flow. The order of sequence flow expresses that the Request Canceled 
option is first and that the Request Compliant option is second. 


General 


Decision v Decisions 


Implementation 


Request Canceled: @ & | NONE v’ & 
Pre & Post - 
Default flow: Request Compliant v| 


Tracking 


__e._ In the first field to the right of Request Canceled, enter: tw. local. isCompliant 
__f. Change the evaluation value to: == 


__g._ Inthe last field to the right, enter the value: "0" 


General 
Decision v Decisions 
Implementation - - 
Request Canceled: twlocalisComplic & == v & 
Pre & Post - 
Default flow: Request Compliant v| 
Tracking 


__h. Save your work. 
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__ 4. Implement the Is Salary Compliant exclusive gateway in the Approve Hire Request linked 
process. When the salary is compliant, the flow must move to the end event. 


__a. Open the Approve Hire Request linked process from the History menu. 


“2 Hiring Request Process QO @dA 
[*¥ Process App Settings 


2) Hiring Request Process ® 


[2] Approve Hire Request ® 


If you don’t see the process in your history menu, open the Approve Hire Request from 
the library on the left. 


Over 


Lom 
__b. On the Definition tab, select the Is Salary Compliant gateway. 


& x 
Ga Check Hire : 
LD) og Request ~ Compliant 


Is Salary End 
Compliant 


System 
w 
pvt] 
= 


Make sure that you select the Is Salary Compliant gateway, not the Is Salary 
Acceptable gateway. 


c. Inthe Decisions section of the Implementation panel (not the Decisions panel) below, 
select Not Compliant, if not selected as the default flow. 


This arrangement makes Not Compliant the default sequence flow. The order of 
sequence flow in the Implementation section ensures that the Compliant option is 
assessed first, and if the first assessment is false, the Not Compliant option is taken. 


d. Inthe first field to the right of Compliant, enter: tw. local.isCompliant 
e. Change the evaluation drop-down value to: == 


f. In the last field to the right of Compliant, type: "1" 


General 


_ 


Implementation 


Compliant twlocalisCompliant & == 


Pre & Post 
Tracking 


Default flow: Not Compliant y 


__g. Save your work. 
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Part 6: Implement routing for an activity 


Effective business process management is about routing the right task to the right teams at the right 
time. Using IBM Business Automation Workflow, authors use lanes (sometimes known as 
swimlanes for a pool) to identify the process teams. Process developers implement routing in the 
process for each activity to the right team in the lane. The goal of this section is to implement the 
teams for the lanes and implement assignment routing for all activities in the process. 


__ 1. Route the Submit Hiring Request activity in the Hiring Request Process to Lane and 
distribution to Last User. 


a. Open the Hiring Request Process. 


b. On the Definition tab, click the Submit Hiring Request activity. 


a = 3 bmit Hiri 

= stan |, SubmitHiring — 

z LS) Request > 
= Start : Is Position 
= New 
= 


Review Needed 


aes 
oa 


c. Open the Assignments > Assignments section. 


General 
implementation Vv Assignments 
Data Mapping 


Assign to: Lane Vv 


Assignments 
9 User distribution: None 


v 
Pre & Post . 
Team filter service: <none> 
Trackin 
9 Experts team: <none> 
Conditions 


__d. Verify that the default assignment for Assign to is: Lane 
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__@e. Change the User distribution to: Last user 


Assign to: Lane 


General 
Implementation 
Data Mapping 
Assignments 
Pre & Post 
Tracking 


Conditions 


User distribution: Last user 


Team filter service: <none> Select | New 
Experts team: <none> 


@B Information 


The Last user option assigns the runtime task to a user who completed an earlier task. 


« Ifthe assignment option is set to Lane, the task is assigned to the user who completed the 
activity that immediately precedes the selected activity in the lane. 


« Ifthe assignment option is set to Team, the task is assigned to the user who completed the 
last task that was assigned to the same team. 


In both cases, the task is assigned only to an established last user, if the user is a member of 
the group that is associated with the task. An established last user is determined by using the 
policy valid for the Lane or Team assignment option. If the user is not a member of the group 
that is associated with the task, then the task is assigned to the task group. 


Because this activity is the first in this lane for this process, the system automatically assigns 
the first task to the user that creates the instance. When a user creates an instance of this 
process, the server displays any screens that are configured for the task. You create those 
screens in the next playback phase. 


__f. Save your changes. 
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__ 2. Create a team and add a member. 


__a._ Inthe process library, click the (+) plus sign next to Teams. Click Team. 


2 


= ; 

i=] 

@ Submit Hiring . 
s © Request ~< 
= Start Is PoSitic 
= New 


New 
Ee ee 


Data 


__b. Name the team General Managers and click FINISH. 


New Team 


Teams representthe teams of users in your enterprise that perform tasks. 
After you create a team, you can add users or teams as members, or define 
an expression to determine membership. 


FINISH CANCEL 


c. Inthe Members section, click the (+) plus sign next to Users. 


v Common v Behavior | 


Name: General Managers Specify members by using: ) Users or groups 
Modified: author1 (Nov 15, 2017, 3:10:20 PM) —— 


Documentation: BIrulz=zz 
a oe v Members 
7 


4& User Groups 
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__d. Add user’ to the team from the list. 


You now have a populated list in the Members section with user1 for the General 
Managers team. 


@® x 


#& User Groups 


__e@. Save your work. 
__ 3. Implement the routing for Approve New Hire Request. 
a. Open the Hiring Request Process. 
b. On the Definition tab, click the Approve New Hire Request activity. 


c. Inthe panel below, in the Assignments > Assignments section, leave the value of 
Assign to: as Lane and the value of User distribution as None. 


General 
Implementation Vv Assignments 
a Assign to: 
intl 
— User distribution: 
Pre & Post : 
Team filter service: <none> | Select... New... | x 
Trackin 
7 Experts team: <none> x 
Conditions 


The default User distribution option is None. IBM Business Automation Workflow does 
not assign the task to any user when using this option. All the other options in this 
selection assign the task to a user of the system. 


d. On the General Manager lane, click the label on the left. 


| 


General Manager 
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__e. Inthe panel below, go to the General > Behavior section, click Select next to Default 
lane team. 


Vv Behavior 


Defaultlaneteam:  &BAll Users System Dat: New... 


Is system lane: LC] 


__f. Click the General Managers team to select it. 


Select Library Item 


44 All Users System Data 
44% Backoround Svstem Data 


4& Managers System Data 
44 Managers of All Users System Data 
4% Process Owner System Data 

4% System System Data 


The General Managers team is assigned as the default team for the General 
Managers lane. 


v Behaviour 


Default lane team: 44 General Managers | Select... New... 


Is system lane: LJ 


__ 4. Assign the General Managers team as the Experts Group for the Approve New Hire 
Request activity. 


__a. On the Hiring Request Process, click the Approve New Hire Request activity. 
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__b. Open the Assignments > Assignments section. Click Select next to the Experts team. 


General 
Implementation 
Data Mapping Assign to: Lane iad 
a | User distribution: None = 
Pre & Post Team filter service: <none> x 
— Experts team: <none= [ Select... ]] New... ] x 
Conditions 


__c. Click General Managers to assign the General Managers team as the Experts team. 


General 
= ae Vv Assignments 
Data Mapping Assign to: Lane = 
Assignments User distribution: None bal 


Pre& Post = Teamfilter service: <none> x 
Trackin 
9 Experts team: 4& General Managers x 


Conditions 


__d. Save your work. 
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Part 7: Review artifact references 


As you add more artifacts to your solution, it is a good time to review artifact references. When you 
work with an artifact in the Process Designer, it is useful to know where the artifact is used so that 
you can see the impact of potential changes that you want to make. 


__ 1. Review the local scope references for the Hiring Request Process artifact. 


__a. With the Hiring Request process open, click the references icon in the status bar at the 
bottom. 


References | 


__b._ Inthe References pane, review the local scope references. 


Hiring Request Process (HR C V 
Recruitment Processes) 


Q Type to filter 


Vv Referenced By (Local Scope) 
No artifacts were found. 
Local scope shows where artifacts are used only in the current process application and 


its dependencies. This is the default view. Currently, you can see that there are no 
artifacts in the process model with a local scope. 


c. Inthe References pane, review the remaining references. 


Vv References 


bd String System Dats 


6 ) 
Vv Business Objects oO 
1) 


Vv Client-Side Human Services 


& Default Ul Human Service ul Toolkit 


Vv Processes 1) 
(a) Approve Hire Request 

44 All Users System Dats 

4% General Managers 


4% System System Dats 
Specifically, the list shows the references to the system toolkit artifacts. For example, 


since you defined a variable to pass between the parent and nested processes, the 
String object is referenced. 
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The numbers on the right are the instances in the project. You should see the same 
number having followed the lab instructions. If not, then your are missing something in 
the lab. 


d. Review local references of the String artifact by clicking the String section. 


Vv References 


Vv Business Objects 


& Default Ul Human Service UI Toolkit 


Vv Processes 1) 


(3) Approve Hire Request 


44% AllUsers System Dsts 
44 General Managers 


44 System System Data 


__e. For the String references, there are two local references pointing to the two process 
models that use the string variable. 


String (System Data) 
Q Type to filter 
Vv Referenced By (Local Scope) 


Vv Processes 


(i) Approve Hire Request 
(3) Hiring Request Process 


Vv References 


No artifacts were found. 


__f. Close the references panel. 


__g. Close the String (Read-only) window. 


DESIGNER INSPECTOR 


® String (Read-only) ~ @ 


HR Recruitment Processes 


The String object is read-only since it is a reference to the System Toolkit. 
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You have completed this exercise. 


Part 8: Export the process application and do cleanup 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a._ Inthe Process Apps tab, click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__c. Enter Exercise 4 solution for the name. 

__d. Click Create. 
__ 2. Export the application. You can only export snapshots. 
a. Click Export next to the snapshot. 


b. Inthe Export Process App window, click Export next to the Exercise 4 solution. It may 
take a minute or two to generate the . twx file. 


Export Process App x 


Select an export file type. 
(©) IBM Business Automation Workflow export (.twx) 


IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated + w Favorites | Archived 


h. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


This exercise looked at setting variables in business processes, implementing an 
intermediate timer event on a process, implementing exclusive decision gateways, and 
establishing routing for an activity. You also evaluated artifact dependencies by 
reviewing the references for some of the artifacts. 


The assets for Playback 1: Controlling process flow, are complete. You now can control 
gateways by assigning values to variables inside the process. The next exercise looks 
at building business objects and creating a reusable client-side human service. 


End of exercise 
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Exercise 5. Playback 1: Business data, 
services, and coaches 


Estimated time 


01:30 


Overview 


In this exercise, by using the core requirements, you determine and create all of the necessary 
assets to support a coach in the Hiring Request Process. You use complex business objects 
(variable types) to organize your data, and pass data into and out of a linked process. You build a 
service and define guided user interactions with a coach. You also implement a service for an 
activity, and map variables between a nested service and an activity. You model the coach by using 
the concept of grids. 


Objectives 


After completing this exercise, you should be able to: 
¢ Determine and organize data when provided with a written process 
¢ Add business objects and object types 
¢ Create a client-side human service 
¢ Add variables and business objects to a process application 
¢ Create and configure a coach to obtain process participant input 
¢ Model a coach by using the concept of grids 
e Add coach controls to control process flow 
¢ Create a client-side human service and coach for the General Manager review activity 


¢ Implement an activity by attaching a service and mapping data 


Introduction 


In Playback 1, you create human services. Users can use human services to access task 
assignments in a web-based user interface. At this stage of development, it is important that the 
functions of the human service are implemented. Users interact with web-based interfaces called 
coaches to complete their assigned tasks. Enhancements can be added later. This exercise is 
about making sure that users have what they need in terms of business data and task assignment 
information to complete the process activity. 


The human services with coaches are implemented on two activities in the Hiring Request Process 
process. The coaches are used during playbacks to provide business data to the process and 
control the process flow. 
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This exercise and the next provide practice in building and moving controls on a coach. Repetitive 
steps are purposely provided to gain experience in this skill. 


This exercise is long, so a break is included in the middle of the instructions. 


Requirements 


Successful completion of exercise 1 because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 4 process application solution that is required to start 
exercise 5. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 
__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise _4 solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Build business objects and variables 


__ 1. Inthis section, you create a complex variable (business object) to hold the position data. 
Then, you use this variable on the coach to allow users to input the position data. Later in 
the lab, you map these variables to move the data through the process. 


a. Open the HR Recruitment Process (HRR) process application. 


b. Inthe library, click the (+) plus sign next to the Data category, and select Business 


Object. 

New 
Data 
Performance ® 2 Exposed Process Value 


& User Attribute Definition 
Files ee 


c. Name the business object Position and click FINISH. 


New Business Object 


Business objects representthe data that is used in an application. You 
can create complex business objects with multiple parameters of different 
variable types to store the data, for example, that a user would enter ina 
form. 


Name: Position| 


FINISH CANCEL 


Always follow the naming convention for the variable names. Variable names are 
case-sensitive. Capitalize the first letter when creating business objects (for example, 
Employee), but use camel case for the parameters or instantiation of the variable (for 
example, employeeId). Camel case refers to a word or string of letters that has no 
space and has an uppercase letter in a position other than the first letter. 
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__d. You now see the settings page for the business object. Add a parameter to the business 
object by clicking the (+) plus sign next to Parameters. 


v Parameters 
® Parameters * 


x 
L 
__@. Change the name of the parameter to: jobTitle 
__f. Keep the variable type as String. 
v Parameters <>] ad Parameter Properties 
v ® Parameters nN Name: 
©@ jobTitle (String) List: LI 
Variable Type: [ Psune] iystem Data[ Select... | New... 
L Documentation: BIU | =ztwzele = | 
RE Gz 


__g. Repeat steps 1d — 1f to add the following parameters: 
- jobDescription (String) 
- jobLevel (String) 
h. Add another parameter that is named: numDirectReports 


i. Change the type of the numDirectReports attribute to an Integer. Click Select to the 
right of Variable Type. In the filter, enter int. You see the Integer variable type. You can 
filter the variable types by typing the letters of the variable type you are looking for. 
Select the Integer variable type. 


Select Library Item 


Business Object 


| 
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j. Verify that the Integer variable type is selected. 


v Parameter Properties 


Name: numDirectReports 

List L] 

Variable Type: @ Integer |3ystem Data 

Documentation: BIU | — = = = s= ae | 
c= = 


__k. Save your process application. Your business object has four parameters. 


v Parameters 


v ® Parameters @ 


®@ jobTitle (String) 
® jobDescription (String) 
®@ jobLevel (String) 1 


® numDirectReports (Integer) 


__|. Close the business object. 


Position v @ 


r | 
aa HR Recruitment Proc 


Le Proce 


___2. Create a second business object that is named CompensationDetails to allow users to 
input compensation data on a coach. 


__a. Click the (+) plus sign next to the Data category in the library, and select Business 
Object. 
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__b. Name the business object CompensationDetails and click FINISH. 


New Business Object 


Business objects represent the data thatis used in an application. You 
can create complex business objects with multiple parameters of different 
variable types to store the data, for example, that a user would enterina 
form. 


Name: CompensationDetails| 


FINISH CANCEL 


c. Add the following parameters for the complex variable CompensationDetails. 
Remember to change the variable type by clicking Select to the right of Variable Type 
to change it to Decimal rather than the default (String): 


-salaryTooffer (Decimal) 
-bonusAmount (Decimal) 


v Parameters 


v ® Parameters @ 
®@ salaryToOffer (Decimal) 
®@ pbonusAmount (Decimal) 


FIG 


__d. Save the process app and close the business object. 


__ 3. Create a business object that is named RecruitingDetails to allow users to input 
recruiting information on a coach. 


__a. Create a business object: RecruitingDetails 
__b._ Include the following parameters in the complex variable: 
-multipleEmployeesNeeded (Boolean) 


-numEmployeesNeeded (Integer) 
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- newPosition (Boolean) 


v Parameters 


v Parameters @ 
®@ multipleEmployeesNeeded (Boolean) 
@ numEmployeesNeeded (Integer) 
® newPosition (Boolean) 


“AG 


__c. Save the process app and close the business object. 


__ 4. Create a fourth business object that is named DepartmentDetails to allow users to input 
department data on a coach. 


__a. Create a business object: DepartmentDetails 
__b._ Include the following parameters in the complex variable: 


-department (String) 
-division (String) 


v Parameters 


y ® parameters ‘o) q 
®@ department (String) 
®@ division (String) 


___c. Save your process application and close the business object. 


__ 5. Create a business object that is named HiringRequisition to save data about the 
requisition. Model this variable to hold the other objects you created. Use this variable as 


the main parent business object to hold all the data for the process. 
a. Create a business object: HiringRequisition 


__b. Add the following parameters: 
-requisitionNumber (String) 
-dateOfRequest (Date) 
-requester (String) 
-datePositionAvailable (Date) 


-hiringManagerComments (String) 


© Copyright IBM Corp. 2019 5-8 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 5. Playback 1: Business data, services, and coaches 


v Parameters 


- Q Parameters (+) 
@ requisitionNumber (String) 

dateOfRequest (Date) 

requester (String) 

datePositionAvailable (Date) 


hiringManagerComments (String) 


__c. Addaparameter that is called position. This time, click Select to the right of Variable 
Type and use the Position business object that you created. 


Select Library Item 


Business Object 12) 


PP ANY System Data 
+ Boolean System Data 
® CompensationDetails 
+ Date System Data 
® Decimal System Data 
® DepartmentDetails 
® HiringRequisition 

® integer System Data 


GEG) 


d. Verify that the variable type is capitalized and the variable name starts with a lowercase 
letter. Recall that business objects are capitalized and variables are not. 


v Parameter Properties 


Name: position 
List LJ 
Variable Type: 
Documentation: BtIU | SEzBlE = | 
DE G= 
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e. Continue to add the other business objects as parameters: 


-compensationDetails (CompensationDetails) 
-departmentDetails (DepartmentDetails) 
-recruitingDetails (RecruitingDetails) 


v ® Parameters @ 


®@ requisitionNumber (String) 

@ dateOfRequest (Date) 
@ requester (String) J 
© datePositionAvailable (Date) 

®@ hiringManagerComments (String) 

® position (Position) 

® compensationDetails (CompensationDetails) 


© departmentDetails (DepartmentDetails) 


aa ae 


® recruitingDetails (RecruitingDetails) 


@ Information 


Use the up and down arrows to move parameters. The order of the parameters is 
important. As you add the business objects to your coach, the parameters are sequenced 
according to where they are in the list. 


__f. Save the process app and close the business object. 


6. Add the requisitionDetails (HiringRequisition) variable to the Approve Hire 
Request linked process as an input and output variable. 


To pass data from the parent process (Hiring Request Process) to your linked process 
(Approve Hire Request), you must create and map variables. Because the linked process 
is a linked process, you must pass the data object to the linked process by way of the input 
and output variable settings in the linked process. Variable mapping is required for linked 
processes because they are a separate process from the parent process. 


__a. Open the Approve Hire Request linked process. 
__b. Click the Variables tab. 


Overview Definition Folders 
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__c. Add an Input variable requisitionDetails (HiringRequisition) to the process. 
After adding the variable, you can expand the requisitionDetails to view its contents. 


vy @ Input @ 


~® isCompliant (String) 
vy ®& requisitionDetails (HiringRequisition) 
@ requisitionNumber (String) 
@ dateOfRequest (Date) 
@ requester (String) 
@ datePositionAvailable (Date) 
@ hiringManagerComments (String) 
» © position (Position) 
» @ compensationDetails (CompensationDetz 
» ©@ departmentDetails (DepartmentDetails) 
> @ recruitingDetails (RecruitingDetails) 
vy © Output @ 
@ isCompliant (String) 


__d. Add an output variable requisitionDetails (HiringRequisition) to the process. 


&@ Important 


When you type in the output name, the variable is immediately flagged because you have an input 
and an output with the same name, but different variable types. The system defaults the variable to 
a String. When you set the variable type to match the type of the input variable, the error 
disappears. This can occur anytime an incomplete definition is made including data mapping. 


v Details 
Name: ®  requisitionDetails 
BIU|= 


Documentation: 


Ih] 
thl 
DT 
1 

lil 
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__@. You added the variables to the subprocess. Save your work. 


Vv Variables 


vy @ Input 
® isCompliant (String) 
vy & Output (+) 
& isCompliant (String) 
@ Private (+) 
2 Exposed Process Variables @ 


@ 
« [x] >] 


Make sure that the input and output variable names exactly match. If the names do not 
match, then you have two different variables in the linked process. The input data to the 
process is not sent as output to the parent process unless you copy the contents of one 
variable into the other. Copying and pasting the variable name is a good practice. 


__ 7. Create and map the requisitionDetails variable from the higher-level process to the linked 
process. 


__a. Open the Hiring Request Process and click the Variables tab. 


__b. Create a private variable: requisitionDetails (HiringRequisition) 


~® Input 
@ Output 
vy @ Private 


al 


OO® 


@ isNewPosition (String) 
@ isApproved (String) 
@ isCompliant (String) 
y ®@ requisitionDetails (HiringRequisition) 
@ requisitionNumber (String) 
@ dateOfRequest (Date) 
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__c. Click the Definition tab. 


Overview Definition Variables Folders Views 
o ¢ 
s pf Submit Hiring 
s e@ » “Request ~—)> 
¥ 

= Start Is Position 
= New 

Review Needed 


__d. Click the Approve Hire Request linked process. 


> Approved Approve Hire... > 


3 Request Gl Is Request 
Compliant 


__@. Click the Data Mapping menu in the Properties panel below. 


General 
: e 
implementation Vv Input Mapping = 
Data Mapping twlocal.isCompliant & D> isCompliant ... 
Pre & Post & & D> requisitionD... 
Tracking 
© Copyright IBM Corp. 2019 5-13 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 5. Playback 1: Business data, services, and coaches 


f. Map tw.local.requisitionDetails to both the Input Mapping and Output 
Mapping sections. Place the cursor in the box next to requisitionDetails (HiringRequest) 
and enter tw. local. and press the Ctrl+Space to view the auto complete options. 
Select requisitionDetails - HiringRequisition. 


General 
Implementation Y _ Input Mapping ) 
Data Mapping tw.local.isCompliant 
Pre & Post & twilocal| 
: @ isApproved - String 
lec @ isCompliant - String 
Conditions @ icNaowDoacitinn —_ Ctrinn 
@ requisitionDetails - HiringRequisition 


__g. Verify your data mapping and save your work. 


Vv Input Mapping S ecm Y Output Mapping S 


twlocal.isCompliant & D> isCompliant.. isComplia.. 2 —_twlocal.isCompliant & 
‘local.requisitionDetails & >> requisitionD.. requisition. > tw.local.requisitionDetails & 


ee Optional 


You have completed part 1 of 3, so you are now approximately a third done with this exercise. The 
next section is large so now would be a good time to take a 10-minute break. 
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Exercise 5. Playback 1: Business data, services, and coaches 


Part 3: Create a reusable client-side human service and define input 
controls 


Up to this point, each activity is implemented by using the Default Ul Human Service. In this 
section, you define and implement custom services and coaches for activities in the process. In the 
next section, you create a coach to collect information from process teams. The custom service 
passes the collected information in the coach to the process. 


Two activities on the process need a coach that has the same fields: the Submit Hiring Request and 
the Approve Hiring Request. One requires the ability to input data, and the other needs the data to 
be read-only with an approval mechanism. In this part of the exercise, you create a single coach for 
both activities. Because the same data can be shown for multiple activities on the process, you 
create a coach that can be reused for data input and viewing data (read-only). 


__1. Create a client-side human service. 


__a._ Inthe Process Designer library, click the (+) plus sign next to User Interface, and select 
Client-Side Human Service. 


HR Recruitment Processes So) Overview Definition Variables aj 


a 
Approve 
WUira De 


New 
User Interface | aaa eee 
Client-Side Human Service as 


Services & Heritage Human service 
@ Theme 
Events ® Coach View 

Localization Resource 


Processes 


Teams 
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Exercise 5. Playback 1: Business data, services, and coaches 


b. Name the client-side human service: Hiring Form. Select the Intended for use on 
multiple devices check box and click FINISH. 


New Client-Side Human Service 


The client-side human service enables you to build, test, and run i yA 


interactive tasks, dashboards, or user interfaces for process instances, 
and is optimized to run in a web browser. 


Name: Hiring Form 


ntended for use on multiple devices 


[_] Use as anested service 


FINISH CANCEL 


Intended for use on multiple devices enables the new service to be used on multiple 
device types. With this option, you can use responsive controls for all the new coaches 
and coach content that you add to the service. 


c. The new human service opens in the Process Designer editor. 


Overview Diagram Variables Coach: Coachv 


po 


—— End 
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Exercise 5. Playback 1: Business data, services, and coaches 


__ 2. Addthe requisitionDetails output variable to the human service. 


__a. Inthe Hiring Form service, click the Variables tab. 
Overview Diagram Coach: Coachv 


__b. Click the (+) plus sign next to Output. 


Overview Diagram Variables Coach: Coachyv 
~® Input GF) 1 
oe 

z x 
@ Private (+) 
a Exposed Process Variables @ rm 
= Environment Variables @ 
Localization Resources @ 


__c. Name the variable: requisitionDetails. Click Select to the right of the Variable type 
option to select HiringRequisition. 


v Details 
Name: requisitionDetails 


Documentation: BIU | =- == 


Is list: CJ 


Variable type: ® HiringReauisition New... 


Because you need all of the parameters of the HiringRequisiton object, you use the full 
object in the coach. If you needed only part of the object, include that parameter and 
map the parameter from the parent object when mapping inputs and outputs. 
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Exercise 5. Playback 1: Business data, services, and coaches 


___3. Because you reuse this coach for multiple activities, add matching input variables to the 
human service. If any data is entered as part of the process instance from the first activity, 


you can present it on the coach. 
__a. Click the output variable requisitionDetails, highlight the name, and copy it. 


Name: requisitionDetails 


Undo 
Documentation: Dok U | 
Cut 


2|@ 


Paste 
Delete 


Select All 


b. Click the (+) plus sign next to Input and paste requisitionDetails into the Name 
field. 
c. Click Select to the right of the Variable type option. 


d. Change the type to HiringRequisition. 


Vv Variables 


vy @ Input 
>» ®& requisitionDetails (HiringRequisition) 
vy & Output 
> © requisitionDetails (HiringRequisition) 
@ Private 
a Exposed Process Variables 
=? Environment Variables 


OOOO © © 


Localization Resources 


__@. Save your work. 
__ 4. Now that the variables are created, add the inputs that are bound to the variables in the 
coach. 
__a._ Inthe Hiring Form service, click the Diagram tab. 


Overview Variables Coach: Coachyv 
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Exercise 5. Playback 1: Business data, services, and coaches 


__b. Click the Coach node on the canvas, and in the General > Common section, change 
the name of the coach to: Hiring Form 


an » Hiring Form 


Start 


General 


Pre & Post Y Common 
Data Change Name: Hiring Form| 


Color: .@eeeee O 7 


5. Build the coach by using a two-column grid and add the Requisition Number and Requester 
variables. Create your coach fields from the Output variables. Build the first section that 
contains all the simple variables from the Requisition Details object. Consider how items are 
laid out. This consideration determines whether the coach is laid out vertically or 
horizontally. This coach lays out items vertically except for the position field. 


__a. For the Hiring Form service, click the down arrow next to Coach: Hiring Form and 
select Hiring Form. 


Overview Diagram Variables Coach: _Hirina Farm v 


When you renamed the Coach in the diagram, the name changed at the top from Coach 
to Hiring Form 


b. Amessage box for selecting a template appears. Select the second option: Start with a 
grid. From the list, select the option Two Columns and click OK. 


Select a Template 


O Start with a default coach 
@ Start with a grid: | mm Two Columns| | 


O Select template: = Single Column Task Template v 


Mi Three Columns 
== Mosaic 


®@ Header Footer 
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Exercise 5. Playback 1: Business data, services, and coaches 


A two-column grid appears for the Hiring Form coach layout. This layout is the layout 
that you start from to build your coach. 


Overview Diagram Variables Coach: Hiring Formv 


OK 


The grid layout and content layout are mutually exclusive. When in grid view, you can arrange 
grids. When in content view, you cannot arrange grids but you can add content to each grid cell. 
The Content / Grid toggle at the top highlights which is displayed. The color of the grids may vary 
slightly depending on your monitor settings. 


CREATE NEW (+) @ © 


__c. Click the Grid toggle to view the grid layout. 


Overview Diagram Variables Coach: Hiring Form v E (O/O) zi 


(#) 


OK 


__d. Click the Content toggle to view the content layout. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__e@. Click OK on the coach canvas to select the button. 


Overview Diagram Variables Coach: Hiring Form v 


| 


General 
Positioning Y Common Y Behavior 
Configuration Lae: © Gi Binding: Select 


__f. Inthe General > Common section, change the label of the control button to: Submit 


General 


— 


Events Help: © 
Visibility 
HTML Attributes 
__g._ The first inputs that you add to the coach are the parameters of the 


requisitionDetails variable. In the left column of the grid, click the white (+) plus 
sign in the middle. 


Overview Diagram Variables Coach: Hiring Formv 


| 
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Exercise 5. Playback 1: Business data, services, and coaches 


__h._ In the newly opened window, click the Variables tab. 


Overview Diagram Variables Coach: Hiring Formv 


|[petertitertot «dS 
an ae on ae 


Alerts Area Chart SDS Badge Bar Chart SDS Breadcrumbs 


Submit 


i— 


<a =| lv] — i 


Check Box 


Button Caption Box Check Box Group Collapsible Panel 
CA =e = pal [2s] 
Configuration Data Data Export Date Time Picker Decimal 


__i. Select Input > requisitionDetails > requisitionNumber. 


Foe ms hh O&O é 


- @ Input 
— «» requisitionDetails (HirinaRequisition) 


@ dateUtHequest (Uate) 


The result is that the requisition number is placed in the left column of the grid and is 
highlighted. 


Overview Diagram Variables Coach: Hiring Form v 


Submit 
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Exercise 5. Playback 1: Business data, services, and coaches 


__j. | Place the cursor over the bottom portion of the highlight to bring up the (+) plus sign. 
Click the plus sign on the highlighted line to bring up the Palette interface. 


Overview Diagram Variables Coach: Hiring Fo 


Requisition Number © 


__k. Click the Variables tab and select Input > requisitionDetails > requester. 


-| Input 
~~ requisitionDetails (HiringRequisition) 
@ frequisitionNumber (String) 
@ dateOfRequest (Date) 


@ requester (String) 


__|. The Requester variable is placed below Requisition Number. 


Requisition Number 


6. Create a panel and populate it with the Date Details business object. 


__a. Place the cursor over the bottom portion of the highlight for the Requester field to bring 
up the (+) plus sign. Click the plus sign to bring up the Palette interface. 
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Exercise 5. Playback 1: Business data, services, and coaches 


Leave the default selection on All, scroll down, and select Panel. 


. rrrrrr : 


| lenter filter text 


ay 


>) r = Se 


Multi Select Navigation Event Note Notification OpenLayers API 
Output Text Panel Panel Footer Panel Header Password 
— © soe a 
¥ ay ss C3 -. 
Pie Chart SDS Places Pop-up Menu Progress Bar OR Code 


v 


__c. Since the panel is put in place with the name already highlighted, change the name to 
Date Details and press the Enter key. 
__d. Place the cursor over the highlighted area “Add content here” in the Panel to bring up 
the (+) plus sign. Click the plus sign to bring up the Palette interface. 
Requester 
Date Details 
_e@. 


Click the Variable tab and select Input > requisitionDetails > dateOfRequest 


__f. Place the cursor over the bottom portion of the highlight for the Date Of Request field to 


bring up the (+) plus sign. Click the plus sign to bring up the Palette interface. 
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Exercise 5. Playback 1: Business data, services, and coaches 


Make sure that you select the correct highlight when adding variables. If the variables 
are not placed in the correct position, you can rearrange them as needed. 


Date Of Request 


___g. Click the Variables tab and select Input > requisitionDetails > datePositionAvailable 


Date Details 


Date Of Request 


PO 


Date Position Available 


P 


__ 7. Create a panel and populate it with the Position Details business object. 


__a. Click the white (+) plus sign on the Panel in the right column grid. 


Requisition Number 


Pp © 


Requester 


Pp 
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Exercise 5. Playback 1: Business data, services, and coaches 


Leave the default selection on All, scroll down, and select Panel. 


erm ass : 


(>) f ( | eS 


Multi Select Navigation Event Note Notification OpenLayers API 
ry 
Output Text Panel Panel Footer Panel Header Password 
= wwe ra +o 
\ 5 see : 
Pie Chart SDS Places Pop-up Menu Progress Bar OR Code 


__c. With the name highlighted, label the panel Position Details. 
__d. Click the empty space below the panel on the canvas to refocus the mouse. 


__@. Place the cursor over the highlighted area “Add content here” to bring up the (+) plus 
sign. Click the plus sign to bring up the Palette interface. 


Position Details 
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Exercise 5. Playback 1: Business data, services, and coaches 


__f. Click the Variables tab and select the Input > requisitionDetails > position 


parameter. 


# Oo 8 & 


2 Be 
— Input 


® requisitionDetails (HiringRequisition) 


—_ 9: 


2 


Position Details 


Job Title 


requisitionNumber (String) 
dateO fRequest (Date) 
requester (String) 
datePositionAvailable (Date) 


hirinaManacerComments ({Strina} 


compensationDetails (CompensationDetails) 


departmentDetails (DepartmentDetails) 


recruitingDetails (RecruitingDetails} 


The section populates with the parameters of the Position variable. 


PT 


Job Description 


PT 


Job Level 


pO 


Num Direct Reports 


PO 
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Exercise 5. Playback 1: Business data, services, and coaches 


__ 8. Create a panel and populate it with the Recruiting Details business object. 


__a. Place the cursor over the bottom portion of the highlight for the Date Details panel to 
bring up the (+) plus sign. Click the plus sign to bring up the Palette interface. 


® 


Date Details 


Date Of Request 


PO 


Date Position Available 


——[®|——- 


b. Leave the default selection on All, scroll down, and select Panel. 
c. Label the panel: Recruiting Details 
d. Click on the empty space below the panel on the canvas to refocus the mouse. 


e. Place the cursor over the highlighted area “Add content here” to bring up the (+) plus 
sign. Click the plus sign to bring up the Palette interface. 


f. Click the Variable tab and select the Input > requisitionDetails > recruitingDetails 
complex object. 


Recruiting Details 


(_] Multiple Employees Needed 


Num Employees Needed 


Pp 


(_] New Position 


__ 9. Create a panel to the right of Recruiting Details and populate it with the Compensation 
Details business object. 


__a. Place the cursor over the bottom portion of the highlight for the Recruiting Details 
panel to bring up the (+) plus sign. Click the plus sign to bring up the Palette interface 


__b. Leave the default selection on All, scroll down, and select Panel. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__c. Label the new panel: Compensation Details and press the Enter key. 


Recruiting Details Compensation Details 


Multiple Employees Needed 
Oh P Ploy Add content here 
Num Employees Needed 


| 


(_] New Position 


d. Place the cursor over the highlighted area “Add content here” to bring up the (+) plus 
sign. Click the plus sign to bring up the Palette interface. 


e. Click the Variable tab and select the Input > requisitionDetails > 
compensationDetails. 


Compensation Details 


Salary To Offer 


pO 


Bonus Amount 


___ 10. Create a panel and populate it with the Department Details business object. 


a. Place the cursor over the bottom portion of the highlight for the Position Details panel 
to bring up the (+) plus sign. Click the plus sign to bring up the Palette interface 


b. Leave the default selection on All, scroll down, and select Panel. 
c. Label the panel: Department Details. 


d. Place the cursor over the highlighted area “Add content here” to bring up the (+) plus 
sign. Click the plus sign to bring up the Palette interface. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__e. Click the Variables tab and select the Input > requisitionDetails > departmentDetails 
complex object. 


Deparment Details 


Department 


Division 


| 


___ 11. Place a grid above the Submit button and add the Hiring Manager Comments input control. 


__a. Switch to the grid view by clicking the Grid toggle. This setting shows the grids on the 
canvas. 


__b. Hover your mouse and click the (+) plus sign on the bottom of the outer-most grid to 
add a grid above the Submit button. 


PO 


Submit 


Your grid should have only a single line between the orange space and the submit 
button. 


Submit 


__c. Switch to the Content view by clicking the Content toggle. 


__d. Inthe middle of the grid cell, click the (+) plus sign and select the Variable tab in the 
Palette. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__e. Select the Input > requisitionDetails > hiringManagerComments variable. The Hiring 
Manager Comments section spans across both columns. 


Bonus Amount 


ee ee 


Po 


Hiring Comments 


PT 


Submit 


__f. Save your work. 


___ 12. Place a grid at the top of the coach and group the Requisition Number and Requester 
variables together, setting them apart from the other data on the screen in a section. 


__a. Switch to the grid view by clicking the Grid toggle. 


__b. Hover your mouse and click the (+) plus sign on the top of the outer-most grid to add a 
grid above the two columns. 


Overview Diagram Variables Coach: Hiring Form v 0/0) r V 


— —s 


Your grid should be above the grid containing the two columns. 


Overview Diagram Variables Coach: Hiring Form v 
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Exercise 5. Playback 1: Business data, services, and coaches 


__c. Switch to the Content view by clicking the Content toggle. 


Overview Diagram Variables —- Coach: Hiring Formv EE fel[e] = wa 


Requisition Number = ; 
rT Position Details 
Requester Job Title 


d. Place the cursor next to the Requisition Number label, hold down the left mouse 
button, and drag the Requisition Number input control to the new grid at the top. 


e. Perform the same action for the Requester input control, placing it under the 
Requisition Number control. Use the yellow highlight as a guide to the placement of the 
control. 


Requisition Number 


__f. Switch to the Grid view. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__g. Verify that your grid was placed above the two columns. 


__h. Switch back to the Content view. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__i. Verify your coach 


Requisition Number 
Requester 
Date Details Position Details 
Date Of Request Job Title 
Date Position Available Job Description 
Job Level 
Num Direct Reports 
(] Multiple Employees Needed 
Num Employees Needed 
Compensation Details 
C) New Position pe 
Salary To Offer 
Bonus Amount 
= | 
Division 
Hiring Comments 
Submit 
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Exercise 5. Playback 1: Business data, services, and coaches 


__j. Save your work. 
___ 13. Run the coach. 


__a. Now that a working coach has variables that are bound to the fields, run the coach and 
view it in a browser. Click Run at the upper-right corner of the window. 


‘) author! Vv @ 
[6] 


@ Troubleshooting 


If pop-up windows are disabled in the browser, the browser prevents the site from opening the 
pop-up window. Click OK. 


€9 Error 


Unable to open a new browser window. Pop-up windows may be 
blocked by the web browser. Configure your browser to allow pop-up 
windows from the host that your process center is installed on. 


To correct the problem in Firefox, in the yellow bar at the top of the browser, click Options > Allow 
pop-ups for ws2016x64. 


Allow pop-ups for ws2016x64 


Edit Pop-up Blocker Options... 


Don't show this message when pop-ups are blocked 


EDM o© 
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Exercise 5. Playback 1: Business data, services, and coaches 


To correct the problem in Chrome, click pop-up blocker icon in the address bar and select Always 
allow pop-ups and redirects from https://ws2016x64:9443. 


ida 2a04-4037-970e-85095633b6d6 Exe (S$) + ] 
x 


Pop-ups blocked: (i) 


* about:blank#blocked 


ws2016x64:9443 


Always allow pop-ups and redirects from https:// 
O Continue blocking | 


The pop-up window that appears shows the coach designer. Close this window and rerun the 


coach. 


© Copyright IBM Corp. 2019 


5-36 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 5. Playback 1: Business data, services, and coaches 


__b. Another browser window opens and displays the coach. 


Requisition Number 


| | 


Requester 
Date Details Position Details 
Date Of Request Job Title 
Date Position Available Job Description 


Job Level 


Recruiting Details | 


Num Direct Reports 
(J Multiple Employees Needed 0 
Num Employees Needed 


( New Position 


Compensation Details 


Salary To Offer 
Deparment Details fo | 
Department Bonus Amount 
a ee 
Division 


Hiring Manager Comments 


pd 


The coach looks exactly like the coach that you created in the designer window. Most of the design 
and functional elements of a coach work the same in the designer as they do after you run the 
coach. The test run gives you an idea of the final page for the business users, but it usually looks 
the same as the coach in the designer view. Keep in mind, testing for a customer production 
situation would entail thoroughly testing the solution on the company supported browser. This 
coach is not meant to be an attractive, fully functioning front end; you add more functional and 
visual features later on in this playback. The intent of this playback is to start data flow. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__c¢._ Click inside the Date Of Request input control to select a date, insert some data in other 
fields, and when you are ready, scroll down to click Submit. 


Date Of Request 


|e [s ||| =| 
midlet le [6 


__d. The pop-up window displays Service completed 


__@. Close the pop-up browser window that you ran the coach in. 


__f. Close the Hiring Form client-side human service window. 


DESIGNER INSPECTOR 


@ Hiring Form v |@ jo Ik>I 
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Exercise 5. Playback 1: Business data, services, and coaches 


Part 4: Reuse and debug the client-side human service 


Because the Approve New Hire Request activity in the Hiring Request Process reviews the 
same data that is entered in the last human service, you can reuse the Hiring Form human service 
to add a service to an activity. 


In the Hiring Request Process modeling effort, many of the activities are placed on the diagram 
canvas with default human services. It is time to implement the services that were created to the 
appropriate activities in the process. In this section, you replace the human services in the Submit 
Hiring Request and Approve New Hire Request activities in the Hiring Request Process 
business process with the appropriate human services. 


__ 1. Implement the Submit Hiring Request activity service. 
__a._ Inthe Process Designer, open the Hiring Request Process process. 


__b. Click the Submit Hiring Request activity. 


2 


a a my bmit Hiri 

(a2) ~ UBMIT AIring 

= Y > Request <> 
= Start Is Position 
£ New 
= 


Review Needed 


__c. Click Select in the Implementation > Implementation properties section and select the 
service that implements the user task. 


General 
Implementation bal Activity Type 
Data Mappin : - 
smi —_ User Task v 

Preconditions 

Assignments v Implementation 
Pre & Post 

Implementation: — @ Default Ul Human Service UI Toolki New... 
Tracking 
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Exercise 5. Playback 1: Business data, services, and coaches 


__d. Select Hiring Form from the list. 


Type v Select Library Item 


Client-Side Human Service 6 
& Client-Side Human Service U! Toolkit 


@ Default Ul Human Service U! Toolkit 


Heritage Human Service 


& €Fire Default BPD Event System Data 


__e. The Hiring Form is now the implementation for the activity. 


v  _ Implementation 


Implementation: @ Hiring Form 


__ 2. Map the Submit Hiring Request input and output. 


__a. Open the Data Mapping menu for the Submit Hiring Request activity. 


General 


Implementation v Input Mapping S 
Data Mappi sa ; 
& & c> fequisitionDetails (H... 


You will see a warning until the input mapping is complete. 


__b. Click the auto-map icon on both the Input Mapping and Output Mapping sections. 


Vv Input Mapping v Output Mapping = 


tw.local.requisitionDetails & G> fequisitionDet... fequisitionDe...c> —_|tw.local.requisitionDetails & 


__c. Save your work. 

__3. Implement the Approve New Hire Request activity. 
__a. Click the Approve New Hire Request activity in the Hiring Request Process process. 
__b. Click Select in the Implementation > Implementation properties section. 


__c. Select the Hiring Form client-side human service from the list. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__d._ The Hiring Form is now the implementation for the activity. 


v _ Implementation 


Implementation: @ Hiring Form 


__ 4. Map the Approve New Hire Request inputs and outputs. 
__a. Open the Data Mapping menu for the Approve New Hire Request activity. 
__b. Map tw.local.requisitionDetails to both Input Mapping and Output Mapping. 


Input Mapping v Output Mapping 


tw.local.requisitionDetails & > requisitionDe requisition... <> tw.local.requisitionDetails & 


__c. Save your work. 


__ 5. Add Script activity to the Hiring Form to evaluate whether the request is for a new position or 
not. 


This script activity determines whether parameter newPosition is set to true. If it is, it 
updates the value of the isNewPosition variable to 1, otherwise it sets the value to 0. 


__a._ Inthe process library, click User Interface > Hiring Form. 


Type ¥ User Interface 


HR Recruitment Process 


Processes Client-Side Human Service 


User Interface 


Services 


__b. Click the Variables tab. 
__c. Click the (+) plus sign next to Output. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__d. Add the variable: isNewPosition (String) 


Y Variables 


vy ®@& Input 

> ®& requisitionDetails (HiringRequisition) 
vy & Output 

> & requisitionDetails (HiringRequisition) 

@ Private 

a® Exposed Process Variables 

=? Environment Variables 

Localization Resources 


® © 
« IP) 


OOO® 


__e. Click the Diagram tab. 


__f. Drag a Client-Side script between the Hiring Form coach and the End event. 


__g. Name the new client-side-script: Map New Position Var 


= 
& 


Map New 


Position Var 


a 
© > Hiring Form & Submit n@) 


Start End 
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Exercise 5. Playback 1: Business data, services, and coaches 


h. Connect the flow between the Hiring Form and Map New Position Var script and then 
to the End event. Straighten your sequence lines as necessary. 


J 


Map New ~O 
—— Submit 
@ > Hiring Form mm position Var 


sta Ld Ent 


fa 


i. Click the Map New Position Var script activity that you placed on the canvas. 


__j. Open the Script section in the properties below. 


This editor uses standard JavaScript syntax. Press Ctrl-space while typing to receive assistance with the script syntax 
and contents 


1// This JavaScript will run within the browser and must use the client-side JavaScript synta> 


2// - To instantiate a complex object: - To instantiate a lis 
3// tw.local.customer = {}; tw.] 
4// tw.local.customer.name = "Jane"; tw. local.address 
5 

4 > 


The client-side script box has some example code commented out. You can erase the 
code, or you can add the code below the commented code. This code provides 
examples of how to instantiate different types of variables. 
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Exercise 5. Playback 1: Business data, services, and coaches 


__k. Copy and paste the following code in the Script field. You can copy the code from the 
file Script1.txt atthe location: C:\labfiles\Support files\Ex5 


if (tw. local.requisitionDetails.recruitingDetails.newPosition == true) 
tw. Llocal.isNewPosition = "1"; 

else 

tw. Local.isNewPosition = "0"; 


This editor uses standard JavaScript syntax. Press Ctri-space while typing to receive assistance with the 
script syntax and contents. 


1// This JavaScript will run within the browser and must use the client-side JavaScrip 


2// - To instantiate @ complex object: - To instantia 
Sef tw.local.customer = {}; 
4// tw.local.customer.name = "Jane"; tw. local 
Sif (tw.local.requisitionDetails.recruitingDetails.newPosition == true) 
6 tw.local.isNewPosition = "1"; 
7 else 
Stw.local.isNewPosition = "0" 
9 
4 b 


__ |. Save your work. 
__6. Debug the Hiring Form client-side human service and verify that data is flowing. 


__a. Click the Debug icon. 


authori Vv @ 


crac © MS 


__b. Anew browser window is displayed, but this time it is in debug mode. 


+ This window is hosting your debug session, and must remain open while you are debugging. 


The running chent-side human service is paused at the first activity. To proceed with the debugging of the chent-side human service, 
use the actions on the sidebar of the Inspector. 


Tf this window is closed, use the ‘Show Playback Window' action to reopen it. 


__c. Minimize this new browser window to view the client-side human service designer 
window. 
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@ Information 


The coach designer switches to the Inspector tab. 


@ HiringForm> @® @ 


__d. The inspector section is displayed on the right side. The status shows that the execution 
is Paused. 


(1) Hiring Form 


“a FEC 


Instance ID: 1 
Process Apo’ HR Recruitment Processes 


VY Locations 


© Hiring Form 


__e. If not already selected, click the Diagram tab. The inspector shows a token that is 
waiting to execute this step in the process. 


(*) 
a 
Hiring Form 


Map New 
Submit > 
Submit position Var 40) 


End 


(wih 


Start 
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__f. Click the Step over icon for the Hiring Form coach. 


(1) Hiring Form 


Vv Details 


Instance ID: 1 
Process App: HR Recruitment Processes 
Status: Paused 


Vv Locations 


© Hiring Form 


__g. The second browser window renders the coach. Enter 12345 as the Requisition 
Number. Ensure that the NewPosition check box is not selected. 


Requisition Number 
12345 
Requester 
Date Details Position Details 
Date Of Request Job Title 
Date Position Available Job Description 
Job Level 
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__h. Click Submit. 


Department Bonus Amount 


Division 


Hiring Manager Comments 


OO 


__i. Minimize the coach browser window and return to the designer browser window. 


The Hiring Form coach is complete, and the token moves to Map New Position Var. 


(sy 


& 


Star — 


= 


Map New 
Position Var 


End 


The status is Paused, waiting for the next step in the service. Click Step over to run the 
Map New Position Var server script. 


_}. 


(1) Hiring Form 


Instance ID: 1 
Process App: HR Recruitment Processes 
Status: Paused 
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k. The status changes to Finished and the token disappears because it reached the end 
event. On the right, expand the Data section and click the (+) plus sign next to 
requisitionDetails to see the updated value for the 
requisitionDetails.requisitionNumber variable. Verify that the updated value for 
the requisitionDetails.requisitionNumber variable is 12345. The 
tw. local.isNewPosition variable is set to the String “O”. 


a 


~ Ss requisitionDetails(HiringRequisition) 

requester(String) <Empty> 

+ departmentDetails(DepartmentDetails) 
hiringManagerComments(String) <Empty> 

+ compensationDetails(CompensationDetails) 
datePositionAvailable(Date) <Empty> 

+ position(Position) 
dateOfRequest(Date) <Empty> 


+ recruitingDetails(RecruitingDetails) 
 isNewPosition(String) 0 


__|. Run the service again, and this time select the New Position check box on the coach. 
The isNewPosition value should be set to 1. 


Recruiting Details 


(_] Multiple Employees Needed 
Num Employees Needed 


ee 


New Position 


m. Return to the Debug Hiring Form and verify that the service is completed. Close this 
browser window. 


n. The Status is Finished, and you are currently on the INSPECTOR tab. Return to the 
DESIGNER tab. The activity and flow highlights disappear in the Designer mode. 


__ 7. Map the new variable in the process. 
__a. Open the Hiring Request Process process. 


__b. Click the Submit Hiring Request activity. 
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__c. Inthe Data Mapping properties section, map the isNewPosition output variable to 
tw. local.isNewPosition. 


vy Output Mapping 


requisition... <> twilocal.requisitionDetails & 


isNewPosit..<> | twlocal.isNewPosition & 


__d. Click the Approve New Hire Request activity. 


__e. Inthe Data Mapping properties section, map the isNewPosition output variable to 
tw. local.isNewPosition. 
f. Save your work. 


You have completed this exercise. 
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Part 5: Export the process application and do cleanup 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


$ Open in Designer 


__c. Enter Exercise 5 solution for the name. 
__d. Click Create. 

__ 2. Export the application. You can only export snapshots. 
__a. Click Export next to the snapshot. 


__b. Inthe Export Process App window, click Export. next to the Exercise 5 solution. It 
might take a minute or two to generate the .twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 
IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated + w Favorites | Archived 


__h. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


Playback 1: Business data and services is complete. In this exercise, by using the core 
requirements, you created all of the necessary assets to support a coach in the Hiring Request 
Process. You modeled the coach using grids and common controls. You used complex business 
objects (variable types) to organize your data, and pass data into and out of a linked process. You 
built a human service and defined guided user interactions with a coach. You also implemented a 
service for an activity, and mapped variables between a linked service and an activity. 


End of exercise 
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Exercise 6. Playback 1: User interface 
design and implementation 


Estimated time 


01:30 


Overview 


In this exercise, you group controls into tabs on a coach and change the appearance of the coach 
by applying a theme. 


Objectives 


After completing this exercise, you should be able to: 
¢ Create tabs on a coach 
¢ Change the appearance of a coach by applying a custom theme 
¢ Change the coach layout for a mobile format 
¢ Configure controls to respond to different screen sizes 


¢ Debug the coach by using a responsive sensor 


Introduction 


In Playback 1, the enhancements that the business wants for process application user interfaces 
are implemented. Often, the initial development efforts are marred with requests to begin with full 
fidelity user interfaces. It is not uncommon to have this request because it is driven from a desire to 
impress executive level stakeholders with prototypical user interfaces that can be manipulated. It is 
better to reserve this type of development for this playback stage. You ensure that the data model is 
in place, the functions of the user interface are approved, and all the remaining process application 
interactions and integrations are complete. Now the enhancements can be done without fear that 
rework would be needed later because of a change in requirements to the items in the prior 
playbacks. Changes can happen, but the likelihood is that those functional requirement changes 
are handled in Optimization and not within the development cycle because consensus is reached to 
move to this stage of development. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 5 process application solution that is required to start 
exercise 6. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 
__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise_5 solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Group controls into tabs on a coach 


In one of the previous playbacks, you provided a functional look at the coaches in the Hiring 
Request Process. Enhance the coaches with more features and functions. Start with creating a 
polished look to the coach by grouping similar data into tabs. 


__1. Create a panel and populate it with two parameters from the Requisition Details business 
object. 


__a. Open the HR Recruitment Process (HRR) process application. 


__b. Inthe Process Designer library, open the Hiring Form. 


User Interface 


HR Recruitment Process 


Processes Client-Side Human Service 


User Interface 


Services 


__c. Click the down arrow next to Coach: Hiring Form and select Hiring Form. 


Overview Diagram Variables Coach, Same Perm <2 


Hiring Form 


__d._ Highlight the Requisition Number input control and place the cursor over the top 
portion of the highlight to bring up the (+) plus sign. 


——e . (al 
Requisition Number 


__@. Click the plus sign on the highlighted line to bring up the Palette interface. 
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f. Leave the default selection on All, scroll down, and select Panel. The panel is placed on 
top of Requisition Number. 


Panel 


Requisition Number 


pT 


__g. Place the cursor next to the Requisition Number label, hold down the left mouse 
button, and drag the Requisition Number input control to the Panel section “Add 
content here” 


h. The result is the Requisition Number is in the new Panel. 


Panel 


Requisition Number 


Pp 


__i. Perform the same steps to place the Requester input control under the Requisition 
Number of the same panel. Use the yellow highlight as a guide to the placement of the 
control. 
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Rename the panel Requisition Details. 


Requisition Details 


Requisition 


Number 


Pp 


Requester 


Po 


___2. Create tabs to hold the grouped sections on the coach. 


highlight to bring up the (+) plus sign. 


control. 


Requisition Details 


Highlight the Requisition Details panel and place the cursor over the top portion of the 


Click the plus sign on the highlighted line to bring up the Palette interface. 


Leave the default selection on All, enter tab in the search bar. Select the Tab Section 


Date Position Available 
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Requisition Number =[2] 
see bd q ka fi ‘ 
| #o8 m2 hh Ow 
Requester | tab | ay 
—— te ee 
; inca 
Service Data Table Layout 
Table Tab Section Table Table Layout Cell 
Date Details 
— 
Date Of Request Table Layout 


Row 


Job Level 


= 
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__d. There is no need to rename the tab section. Click the empty space inside the tab control 
to refocus the mouse. 


Olom 


Requisition Number 


__ 3. Build the Requisition Details tab. 


__a. Drag the Date Details panel that contains the Date of Request and the Date Position 
Available input controls into the editable area of the panel under Requester. 


Requisition Details 


Date Details 


Date Of Request 
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__b. Your coach should look like this screen capture after you add the Date Details panel. 


Requisition Details 


Requisition Number 


PY 


Requester 


PO 


Date Details 


Date Of Request 


pO 


Date Position Available 


po 


__c. Drag the Hiring Manager Comments control underneath the Date Details panel in the 
Requisition Details panel. 


Date Of Request 


pO 


Date Position Available 


pO 


Hiring Manager Comments 


Pd 
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d. Drag the Requisition Details panel into the tabs area that is labeled Add content here. 
The label on the tab changes to match the label that is applied to the panel, and a 
second tab opens. 


Requisition Details | 4 


Add content here 


e. Click the tab to view the Requisition Details. 


__f. Your Requisition Details tab should look like the screen capture. 


Requisition Details | 4 


Requisition Number 


pT 


Requester 


pO 


Date Details 


Date Of Request 


pO 


Date Position Available 


pO 


Hiring Manager Comments 


pO 
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__ 4. Build the remaining four tabs. 


__a. Click the (+) plus sign on the tab next to the Requisition Details tab. 


Requisition Details [+] 


__b. Drag the Position Details section onto the section titled “Add content here”. This one is 


easier because all the controls are already in a single section. 


Requisition Details | Position Details} > 


Job Title 


pO 


Job Description 


PO 


Job Level 


po 


Num Direct Reports 


pO 
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__c. Create a tab for the Recruiting Details. This time, drag the header for the Recruiting 


Details panel to the right of the Position Details tab. Notice that an orange line 
indicates where the new tab is placed when you release the mouse button. 


Requisition Details | Position beta || 


Recruiting Details 


(_] Multiple Employees Needed 
Num Employees Needed 


pO 


(_) New Position 


__d. Release the mouse button, and the section becomes the Recruiting Details tab next to 


the Position Details tab. 


Requisition Details Position Details | Recruiting Details | 4 


(_] Multiple Employees Needed 


Num Employees Needed 


pO 


(_] New Position 
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__e@. Continue to create tabs for the Compensation Details and Department Details. Drag 
each of the respective sections onto their tabs. 


Requisition Details Position Details Recruiting Details Compensation Details Deparment Details + 


Division 


Pt 


__ 5. Delete the empty grids. 
__a. Return to the Grid view. 


__b. The empty grids are displayed. Right-click each empty grid and click Delete. 


__c. Now only the grid with the tabs is left with the Submit button at the bottom. 


Overview Diagram Variables Coach: Hiring Form v & 


Submit 


__d. Return to Content view. 


__e. Save your work. 
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__6. View the coach. 


__a. Click Run at the top of the coach. 


~) authori V @) 
“cl 


__b. The coach now has multiple tabs. Click the tabs to see what is contained on each tab. 


Requisition Details Position Details Recruiting Details Compensation Details 


Requisition Details 


Requisition Number 


PT 


Requester 


PT 


Date Details 


Date Of Request 


poe 


Date Position Available 


Hiring Manager Comments 


PT 


Submit 


__c. Close the browser that displayed the form. 
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Part 3: Change the appearance of the coach by applying a custom theme 


Creating a theme consists of assigning values to a set of theme variables. By default, a new 
process application uses the Classic Theme because it contains all the variables that the controls in 
the UI Toolkit use. To create a custom theme and use any of these settings in your process 
application, you use the Classic Theme as your starting point. You can then extend your theme by 
adding custom variables and modifying the variables. 


__ 1. Create a custom theme for the HR Recruitment Processes process application. 


__a. Click Create New on the upper-right corner of the Process Designer. 


‘) author! Vv @ 
@© 


__b. Click Theme. 


ie 


(a= Process 
&) Blueworks Live Subscription 
& Client-Side Human Service 


{ d&& Heritage Human Service 


Coach View 
Localization Resource 
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c. Enter the name: Hiring Request Theme 


Leave the option Copy an existing theme: Classic (System Data) selected and click 


FINISH. 


New Theme 


A theme sets the visual style of the coaches within a process application 
or toolkit. A theme can also apply to a portal in Process Portal. 


Hiring Request Theme 


®) Copy an existing theme 


Classic (System Data) 
Import a theme file 


Choose File | No file chosen 


__d. The editor opens the new theme and defaults to the Design tab. 


Overview Design 


~ Base Settings 


@bpm-neutral-darkest 
@bpm-neutral-darker 
@bpm-neutral-dark 
@bpm-neutral 
@bpm-neutral-light 
@bpm-neutral-lighter 
@bpm-neutral-lightest 
@bpm-color-primary-light 
@bpm-color-primary 
@bpm-color-primary-dark 
@bpm-color-primary-darker 
@bpm-color-info-light 
@bpm-color-info 
@bpm-color-info-dark 
@bpm-color-info-darker 
@bpm-color-success-light 


@bpm-color-success #c8f08t Radio Button Group Date Time Picker 
@bpm-color-success-dark darken(desaturate(spin(@bpr © Option 1 
7 : Tuesday, May 9, 2017 
@bpm-color-success-darker darken(desaturate(spin(@bpr oO Option 2 
@bpm-color-warning-light lighten(@bpm-color-waming,. May 2017 
@bpm-color-warning #ide876 Check Box Group 
@bpm-color-warning-dark darken(desaturate(@opm-col Option 1 Tw 
@bpm-color-warning-darker darken(desaturate(spin(@bpn | OD Option 2 
@bpm-color-alert-ight lighten(saturate(spin(@bpm-c = 
an ai a ————— 


Source 


#001111 
#243737 
#304646 
#586464 
#647777 
#c8d2d2 
#ofe9e9 
lighten(desaturate(spin(@bpn 
#22580 =a 
darken(desaturate(spin(@opr 
darken(desaturate(spin(@opr 
lighten(@bpm-color-info, 11% 
#c0e6f 
darken(spin(@bpm-color-info, J 
darken(desaturate(spin(@opr J 
—s 
— 
a 
a 
[__di 


lighten(@bpm-color-success, 


Controls Tables Containers Pop-ups and Dialogs 


Input Fields (Text, Integer, Decimal, Text Area, Type Ahead Text, Multi Select, 
Single Select) 


Input Input Small input Large 
Buttons 
Danger L: arg e Small Extra-Smail 
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___2. Change the primary color of the theme 


Management wants to change the color scheme to match the corporate color scheme. Change 
the settings of the default Classic Theme and apply the new theme to the process. 


__a. Inthe Design page of the theme editor, change the variable @bpm-color-primary in 
the Base Settings section from #325C80 to: #bcc2c5 


Overview Design Source 
v Base Settings 

@bpm-neutral-darkest #0d1111 

@bpm-neutral-darker #203737 

@bpm-neutral-dark #34646 

@bpm-neutral #586464 

@bpm-neutral-light #667777 

@bpm-neutral-lighter #c8d2d2 

@bpm-neutral-lightest #dfe9e9 
@bpm-color-primary-light liahten(desaturate(spin(@bon 
@bpm-color-primary #bec2c5 
@bpm-color-primary-dark darken(desaturate(spin(@bpn ff 
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rd) Note 


Many variables also have a swatch that you can click, then choose a value directly from a picker, 
and click OK. 


al 
LLL 
TT Lie 
TELL 
TL ie 
Tascam 
Tite 
mt | ie 


2 
gi 
Bg 
= 
a 
Cust 
= 
a 


Nefine Custom Colors >> 


@bpm-color-alert #ad1625 
@bpm-color-alert-dark darken(desaturate(spin(¢ x 


__b. When you “blur” or click away from the color input field, you immediately see the color 
change for the affected controls on the right. Click any control on the right to see the 
CSS that affects the appearance of that object on the page. 


@bpm-color-primary #bcc2c5 
@bpm-color-primary-dark darken(desaturate(spin(¢ |) Radio Button Group Date Time Picker 
@bpm-color-primary-darker darken(desaturate(spin(¢ MN 


7 © Option 1 
@bpm-color-info-light lighten(@bpm-color-info, O Option 2 , 
@bpm-color-info #c0e6ff —_—T 
. ei i 2 .] | j 1.| 
@bpm-color-info-dark darken(spin(@bpm-color: (| Check Box Group Font family: @bpm-font-family-base ® 


Font size: @bpm-font-size-base 
@bpm-color-info-darker darken(desaturate(spin(¢ | Option 1 Font color: @bpm-fill-normal 


@bpm-color-success-light lighten(@bpm-color-succ (J Option 2 Background color: @bpm-color-primary 
Border color: @bpm-neutral 
@bpm-color-success #c8f08f [ l Lert 
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___3. Change the font color of the tabs. 
__a. Click the Containers tab on the right. 


Controls Tables Pop-ups and Dialogs 


Tabs 


Tab 2 Tab 2 


Tab 1 Tab 2 18 Tat Tab 2 


Tab 2 


Tab 1 


__b. Hover over the Primary Tabs control in the first row in the right column. It shows all the 
variables that are associated with this control. For example, to change the font color of 
the tabs, you need to change the value of the @bpm-tabs-primary-color variable. 


«Click for pop-up> 
Height: @bpm-tabs-height 


Font family: @bpm-font-family-base 
Font size: @bpm-font-size-base 
Tr, Font color: @bpm-fill-normal 
___| Background color: @bpm-tabs-default-bg 
Zz Border radius: @bpm-tabs-border-radius 
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__c.  Tochange the font color, collapse the Base Settings section and expand the Tabs 
section. 


Overview Design Source 


> Fonts 


> Forms 


> Buttons 


>» Checkbox : Switch 
> Section 


> Table 


@bpm-nav-link-padding 10px 15px oe 
@bpm-nav-tabs-border-color @bpm-neutral-dark ey 
@bpm-tabs-default-color @bpm-text-color-negative 


@bpm-tabs-default-bg @bpm-color-primary 


__d._ Look for the variable @bpm-tabs-primary-color and change the color to: #008000 


@bpm-tabs-default-accent desaturate(lighten(@bpm- _ | 
(@bom-tabs-default-content-ba @bom-fill-normal 


@bpm-tabs-primary-color #008000 - aa 
@bpm-tabs-primary-simple-color @bpm-text-color =a 
@bpm-tabs-primary-bg ‘@bpm-color-primary 7 
@bpm-tabs-primary-border darken{ @bpm-tabs-prima aan 


You can choose to use any color of your choice. If you run into any problem, return to 
the step and follow that exactly, and then you can customize the color. 


__4. Change the font size. 
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To change the font size, you need to change the value of the @bpm-font-size-base 
variable. 


Tab 2 


«Click for pop-up> 
Height: @bpm-tabs-height 


Fant farmihe Mhnm_fantfamihehacs 


=; Font size: @bpm-font-size-base 


1) Font color: @bpm-fill-normal 
_| Background color: @bpm-tabs-default-bg 
Border radius: @bpm-tabs-border-radius 


__a. Collapse the Tabs section, and expand the Base Settings section. 


__b. Look for the variable @bpm-font-size-base and change the value to: 16px 


Overview Design Source 


@bpm-fill-normal Fit 


@bpm-border-normal lighten(@bpm-neutral, 2%) aS 
@bpm-link-color @bpm-color-primary 


@bpm-text-color #000203 Be 


@bpm-font-family-sans-serif “Helvetica Neue”, Helvetica, £ Lorem Ipsum 
@bpm-font-size-base 16px 
@bpm-line-height-base 15 


___5. Change the background color of the input controls. 


__a. Click the Controls tab on the right to view the input fields. 


Tables Containers Pop-ups and Dialogs 


Input Fields (Text, Integer, Decimal, Text Area, Type Ahead Text, Multi 
Select, Single Select) 


Input Input Small 
Input Large 


___b. Expand the Forms section on the left. 
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__c. Change the variable @bpm-input-bg to: #d9ece3 


@bpm-label-font-family @bpm-fontfamily-base Lorem ipsum 
@bpm-label-font-weight bold Lorem Ipsum 
@bonm-lahel-text-color inherit 

@bpm-input-bg #d9ece3 

@bpm-input-bg-disabled @bpm-neutral-lightest 
@bpm-input-color @bpm-text-color | 


__d. Click empty space outside the input control to refocus the mouse. The colors of the input 
controls are now highlighted with the chosen color. 


__@. Save your work. 
__ 6. Apply the new theme to the HR Recruitment Processes process application. 


__a. Open the Process App Settings from the History menu on the top. 


DESIGNER INSPECTOR 


® Hiring Request Theme ® 


[ Process App Settings 


% Hiring Request Iheme ® 
@ Hiring Form ®) 


__b._ Inthe Coach Designer Settings section, click Select. 


Coach Designer Settings 


Theme: @ Classic System Date|[ Select ]] New... ] 
Heritage Coach XSL- (| CoachDesignerxs! System Data| Select. | New. 
Heritage CoachCSS: (coach designercss © System Data 


__c. Select Hiring Request Theme. The theme is now changed to the new theme. 


Y Coach Designer Settings 


Heritage Coach XSL: Gl CoachDesignerxs! System Data 
Heritage Coach CSS: je coach designercss System Data 


__d. Save your changes. The save generates the CSS that the browser uses to display the 
controls in the layout. 
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__ 7. Verify the theme changes 
a. Open the Hiring Form Client-Side Human Service. 


b. Click the Run icon at the upper-right side to display the coach with the custom theme. 
Initially when you view the coach, the server must generate the CSS and render the new 
coach on the screen, so a delay might occur before you see the effect. 


~ author! Vv @ 
o[6] 


The coach has the changes that you made in the Hiring Request Theme. 


Position Details Recruiting Details Compensation Details 


Requisition Details 


Requisition Number 


—SSS=!= 


Requester 


SS 


Date Details 


Date Of Request 


PT 


Date Position Available 


a eee 


Hiring Comments 


PT 


Submit 


__c¢. Close the browser window. 
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Part 4: Customize controls 


The coach framework offers many ways of customizing input controls and views. This part of your 
exercise shows some of the popular ways to customize your coach. 


__ 1. Add an icon to the Date Details panel. 
__a. Select the Requisition Details tab on the coach. 


__b. Click the Date Details panel. 


Date Details 


Date Of Request 


—————es | 


Date Position Available 


pT 


__c. With the Date Details panel highlighted, click the Select Icon icon. 
Requester 


00 0 


Date Details 


Date Of Request 


ee ee: SA =| 


Date Position Available 


SS 


__d._ Inthe search field, enter calendar. 
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__e@. Select the first icon in the list. 


Select an icon - 


calendar Q 


feje ae 6 6 


it 


calendar 


__f. The Date Details section now displays a calendar icon in the header of the panel. 


Date Details 


Date Of Request 


_————— al 


Date Position Available 


ey 


___2. Change the appearance of the submit button. 


__a. Select the Submit button on the canvas. 


__b. With the Submit button highlighted, click the Select Icon icon. 


eogo— 
[sont 


Submit 


__c._ Inthe search field, enter send. 
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__d. Select the first icon in the list. 


Select an icon 


send Q 


[a] 


__e. Click the Select Color icon. 


Ceele 


Submit 


__f. Select the Primary color. 


rd) Note 


The picker icons support the most popular configurations. For some configurations, you need to 
access the Configuration properties. 


__g. Click the Configuration properties tab and expand the Appearance settings. 
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__h._ Notice the Color style and Icon which was configured in the prior steps. Set the shape 
style to Rounded. The button on the canvas reflects these settings as you make your 
configuration changes. 


General 
Positioning > Behavior 


Configuration 


Events 
Visibility Color style: © Primary 
HTML Attributes Shape style: © Rounded 


Size: © 4 Defaut 
Outline only: © CT] 
Icon: © = fa-send 


Width: © 4%: 


__i. Click empty space outside the input controls to refocus the mouse. 


__j. The Submit button now displays the new configuration. 


__k. Save your work. 


3. Set the Num Employees Needed input control to visible only if the Multiple Employees 
Needed checkbox is selected. 


It is common to hide controls and display them only when applicable. Since the Num 
Employees Needed input control is not needed unless there are multiple employees, this 
control is hidden until the Multiple Employees Needed check box is selected. 


__a. Click the Recruiting Details tab. 

__b. Select the Num Employees Needed input control 
c. Select the Visibility properties section below 

d. Click the Rule option for Source. 


e. Click Variable for the Add rule for option. 


General 


Positioning Source Value Rule Script 


Configuration | Set to: Same as parent ~ When: (variable) [| Select. ] Condition: Equal to v Value (+) [3] (34) ee & 


Events Otherwise: Same ac narant v 


Visibility Add rule fo Team 


HTML Attributes 
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__f. Select None for the Set to value. 


[Sette [Same as parent [| wnen Wa 


| Same as parent 
Required 
Editable 

| Read only 


ES Hidden Fog 


__g. Click Select. 


General 


Positioning Source: Value @)Rule () Script 


v 


Events Qtherwise: Same as parent 


| Visibility Add rule for:| Variable || Team 


HTML Attributes 


h. Navigate to Input > requisitionDetails > recruitingDetails > 
multipleEmployeesNeeded (Boolean) 


— ~ inp a 

— @ requisitionDetails (HiringRequisition) 

@ fequisitionNumber (String) 

dateOfRequest (Date) 
requester (String) 
datePositionAvailable (Date) 
hiringManager (String) 
hiringComments (String) 
position (Position) 
compensationDetails (CompensationD 
departmentDetails (DeparimentDeitails 
recruitingDetails (RecruitingDetails) 
@ numEmployeesNeeded (Integer) 
@ newPosition (Boolean) 
- @ Output 

+ ™@ requisitionDetails (HiringRequisition) 7 


® @@6mUh]MmUhC OhUhCcMhhC<C MMU hFhUhlUh!O 
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__i. Your rule is now configured. 


Source Value @)Rule Script 


Set to: None Y When: @ requisitionDetails recruitingDetails multipleE mployeesNeeded (Boolean) { Select. Condition: Equalto |v Value: 
Otherwise: Same as parent v 
Add rule for: Variable Team 


The rule determines when to set the input control to “none.” Since the input control is a 
Boolean, the value is depicted as true (Value check box marked) or false (Value check 
box not marked). This rule states: 


Set visibility to “None” when multiple.EmployeesNeeded has a false value otherwise 
inherit the visibility setting from the parent. 


@ Information 


Visibility settings are described below: 


Visibility Setting Description 


Inherits visibility setting from the parent (in this case, that would be the 
Same as parent 


panel). 
Required Input control must have data before coach can complete 
Editable Input control is editable 
Read only Input control can only be viewed, not edited 


Input control is not displayed including the space that it takes up on the 


None 
coach 


Input control is not displayed, not including the space that it takes up. 

Hidden In this case, the space the control takes up does not change even 
though the control is hidden. This is useful if you do not want fields 
moving as a result of a field not displaying. 


__j. Save your work. 


__k. Test the visibility setting by running the coach. 


~ author! Vv @ 


caren © BMG) 


__|. In the Coach window, click the Recruiting Details tab. 
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__m._ If you configured the visibility setting correctly, the Num Employees Needed input 
control is not visible since the Multiple Employees Needed value is false. 


Requisition Details Position Details [_ecruing nets | Compensation Details Department Details 


Recruiting Details 


C) Multiple Employees Needed 
OC) New Position 


__n._ Test the setting by clicking the Multiple Employees Needed check box, setting the 
value to true. The Num Employees Needed input control displays below. 


__ 0. Close the pop-up browser window that you ran the coach in. 
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Part 5: Modify the mobile layout 


You are going to change the layout of the coach to the mobile layout so that the coach is displayed 
correctly on a mobile device. You make a few of the sections collapsible and change the width of a 
few input controls based on the width of the browser window. 


__ 1. Configure the width of the Submit button to respond to the screen size. 


__a. Toggle the Properties section off by selecting the Properties icon in the bottom status 
bar. 


Q Hint 


Press Ctrl and + or Ctrl and - to increase and decrease the browser zoom setting. 
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__c. The Hiring Form is presented in a small screen size resembling a phone. Your screen 
might look different if you are focused on a different tab. 


eeeee 4 a 8:00 AM 


Requisition Details Position Details Recruiting Details 


Compensation Details Department Details + 


Requisition Details 


Requisition Number 


Po 


Requester 


Date Of Request 


aes 


Date Position Available 


aie 


Hiring Comments 


—————EE 


__d. Toggle the Properties section on. 


__e. Select the Submit button. 
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__f. Click the Configuration properties tab and expand the Appearance properties settings. 


__g. Enter 100% in the Width configuration value. 


General 
Positioning 
Configuration 
Events 
Visibility 


HTML Attributes 


>» Behavior 


~ Appearance 


Color style: © Primary Vv 
Shape style: © Rounded v 
Size: © ">| Defautt v 
Outline only: © CL] 

Icon: © = fa-send 


Width: rs] 100% 


After you refocus the mouse, the icon changes to the small screen icon. This means that 
the setting is only made for the small screen size. You can configure different widths for 
the three different screens. The original setting for the large screen size has not 
changed. Make sure you refocus the mouse after changing the settings to verify the 
correct screen size setting. 


h. The Submit button now expands to 100% of the screen. 


___2. Configure the width of the Date Details panel to respond to the screen size. 


You can change the width settings in either the Configuration tab or the Positioning tab. 
When adding values for multiple screen sizes, it is recommended to use the Positioning tab. 
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__a. On the Requisition Details tab, select the Date Details panel. 


| Date Details gS | 


Date Of Request 


Date Position Available 


b. Click the large screen icon above the palette. 


© © 
Gol] «a 


c. Set the Positioning > Width properties to 50%. The entered width is applicable only for 
large screen devices. Click the space outside the input control to refresh the icon. The 
icon is set to large screen. 


d. Refocus the mouse. 


Margin: = 


Heights) T Padding: 
| 


e. Click the medium screen icon above the palette. 


EEE °° 


f. Set the Positioning > Width properties to 100%. The entered width is applicable only 
for medium screen devices. Click the space outside the input control to refresh the icon. 
The icon is set to medium screen. 


When you set the tablet setting (medium screen), the small screen automatically is set to 
100%. This setting is inherited from the tablet format setting, so you do not have to set it to 
100%. 
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__g. Refocus the mouse. 


— foci 


Height:4"= 
| 


t Margin: wz =| @ 


t Padding: "= 
__h. Click the small screen icon above the palette. 

© 
[jo 


__i. Verify the width settings are set to 100%. 


ios J 100% 7 
Height: 4° 
l 


__j. Save your work. 
___ 3. Configure a responsive sensor. 


__a. Highlight the Submit button and place the cursor over the bottom portion of the 
highlight to bring up the (+) plus sign. 
Ww 


eo) 


__b. Click the plus sign on the highlighted line to bring up the Palette interface. 
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__c. Leave the default selection on All, and select Configuration. 


[#]ad oe meh BS 


en ter filter text a ‘ 


7 ial 30 All » 


Alerts Area Chart SDS Badge Bar Chart SDS Breadcrumbs 


4 — 


= ; = ; ; 
Fox | -— vy) = = 
: Check Box 
Button Caption Box Check Box Collapsible Panel 
| Group 
—p 
= &§ & & 
Configuration Data Data Export Date Time Picker Decimal 


__d. Under the Configuration properties, enable the option to turn Debugging On. 


General 

Positioning Debugging on: © 

Configuration > Logging 
Events 
> Parameters: © 

Visibility 

. . eos 

HTML Attributes Internationalization 


__e. Highlight the Configuration object and place the cursor over the bottom portion of the 
highlight to bring up the (+) plus sign. 


__f. Click the plus sign on the highlighted line to bring up the Palette interface. 
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__g. Enter resp in the search bar and select Responsive Sensor. 


= co Him 2 hh Oe 


Responsive 
Sensor 


__h._ Place the cursor over the highlighted area “Add content here” to bring up the (+) plus 
sign. Click the plus sign to bring up the Palette interface. 


__i. Leave the default selection on All, scroll to the bottom, and select Vertical Layout. 


[Ik Bes hh GO & 


filtes o 
iter text 


Text Area Text Editor Text Reader Timer Tooltip 
Type Ahead 
seats Variant Vertical Layout Video Well 
Text 
hm 
Custom HTML 


¥ 


The Responsive Sensor requires a horizontal or vertical layout to correctly calculate the 
screen size. When the coach is run, the browser width is displayed in this Responsive 
Sensor as soon as the browser is resized to test the responsive settings. 
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__j. Save your work. 
__ 4. Verify the coach display for different screen sizes. 
a. Click the Run button. 


A new browser window displays the coach and the width is shown at the bottom. The 
Date Details panel in this image spans the entire browser window because the initial 
width is set to a medium screen size setting. Depending on the size of your screen, the 
layout width might vary. 


Position Details Recruiting Details Compensation Details =- 


Requisition Details 


Requisition Number 


———_E EEE 


Requester 


eee 


Date Details 


Date Of Request 


——————————— 


Date Position Available 


Hiring Comments 


ee 
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Recall the sizes for each screen. 
Table 1. Screen sizes 


Icon Size Resolution 
UJ Small 640 pixels or less 
a Medium 641 - 1024 pixels 
LA Large More than 1024 pixels 
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__b. Slowly reduce the width of the browser. When you pass the 640 pixels threshold, the 
Submit button expands to 100% of the screen width. 


Requisition Details Position Details Recruiting Details 
Requisition Details 


Requisition Number 


Peter 


Requester 


Se 


Date Details 


Date Of Request 


SSS | 


Date Position Available 


Submit 


Width: 639px 
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__c. Now expand the browser window. When the width passes 1024 pixels, the Date Details 
panel contracts to 50% of the browser width because of the responsive control settings 
based on the large screen width setting. 


Position Details Recruiting Details Compensation Details Department Details 


Requisition Details 


Requisition Number 


eS ee 


Requester 


Date Details 


Date Of Request 


| 


Date Position Available 


aaa 


Hiring Comments 


__d. Close the browser window. 


__@. Click the Configuration on the canvas. On the Configuration properties menu, clear 
the Debugging on check box to remove the width display on the coach. 


General 
Positioning Debugging on: © C1 
Configuration > Logging 
Events 
> Parameters: © 
Visibility 
: : are 
HTML Attributes Internationalization | 
__f. Save your work. 
You have completed this exercise. 
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Part 6: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
___a. Return to the Workflow Center. 
__b. Click the HR Recruitment Process process application. 


__c. Click Create New Snapshot on the right side. 


*F Create New Snapshot 


$ Open in Designer 


__d. Enter Exercise 6 solution for the name. 
__e. Click Create. 

__ 2. Export the application. You can only export snapshots. 
__a. Click Export next to the snapshot. 


__b. Inthe Export Process App window, click Export. It might take a minute or two to 
generate the . twx file. 


Export Process App x 


Select an export file type. 

(©) IBM Business Automation Workflow export (.twx) 
IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


{2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


@ Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | #& Favorites 
e. Click Delete. 


Logged in as author! (author1) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 
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__g. Click All. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated + w® Favorites | Archived 


__h.. Verify that HR Recruitment Process is no longer listed. 
This concludes the solution export and cleanup. 


Playback 1: User interface design and implementation is now complete. In this exercise, you 
completed the following: 


¢ Created tabs on a coach 

¢ Changed the appearance of a coach by applying a custom theme 
¢ Changed the coach layout for a mobile format 

¢ Configured responsive controls 

¢ Debugged the coach by using a responsive sensor 


As part of the development process, you now review the playback and examine its functions in the 
Process Portal. In the next exercise, you test the following functions by performing a playback: 


¢ Does the process follow the correct paths? 
¢ Does the application work as expected in the Process Portal? 


As part of the playback, you demonstrate the process application in the Process Portal. You then 
create a toolkit in the Workflow Center and export your process application. 


End of exercise 
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Exercise 7. Playback 1: Conducting the 
Playback session 


Estimated time 


01:00 


Overview 


This exercise covers how to conduct a Playback of your process. The exercise demonstrates the 
process, following various paths that flow from the exclusive gateways in the process and 
demonstrate tasks that are assigned. It also describes the task that is created in the Process Portal 
inbox, depending on the swimlane and routing settings for an activity. You also create a toolkit to 
store and share these assets. 


Objectives 


After completing this exercise, you should be able to: 
e Log on to the Process Portal and create an instance of a process 
¢ Demonstrate that the process follows the various paths modeled 
e¢ Use Process Portal to view the state of activities in a process 
¢ Create a toolkit 
¢ Create a snapshot in the Workflow Center 


¢ Export the process application 


Introduction 


The following list provides a quick view of what to accomplish in the playback portion: 
1. Log on to the Process Portal and create a process instance. 


2. Logon to the Process Portal as two different teams to show that the correct process team is 
being assigned the correct task. 


Complete the human activities. 
4. Demonstrate that the correct path is followed. 


Change variable values and demonstrate following a different path. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 6 process application solution that is required to start 
exercise 7. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. 
__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
& Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise_6 solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 
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Part 2: Prepare for the playback 


To enable a well-run playback in a customer engagement, you should practice running through the 
model beforehand. It is recommended that you run through the playback with a colleague several 
times to ensure a smooth presentation. This can also aid in finding unexpected issues. 


It is common to prepare your environment for the playback to exemplify specific functionality 
explicitly demonstrated for the playback. In the case for this playback, to facilitate activities timing 
out in order to demonstrate different activity statuses in the Gantt chart, you change the timeout 
settings in two activities. 


__ 1. Change the priority and timeout value for the Complete Hire Request activity. 
__a. Open the HR Recruitment Process (HRR) process application. 
__b. Open the Hiring Request Process. 


__c. Click the Complete Hire Request activity. 


“N 
Approve Hire... wy 
yA 
z Is Request Request Compliant 
Compliant 
¥ 
| 
Request Canceled Review 
Posting 
| 
Complete Hire O 
Request 
End 
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__d._ Inthe Priority Settings section of the Implementation properties at the bottom, leave 
the Priority setting as the default and set the activity to be due in 1 minute. 


VY Priority Settings 


Priority: Normal (default) 

Due in: &, [Minutes 00:00 
Time schedule: (use default) 

Timezone: > (use default) 


Holiday schedule: @ (use default) 


Task Header 


__ 2. Change the priority and timeout value for the Review Posting activity. 


__a. Click the Review Posting activity. 


__b._ Inthe Priority Settings section of the Implementation properties at the bottom, select 
Highest for the Priority setting. 


__c. Set the activity to be due in 20 minutes. 


Priority Settings 


Priority: @) Highest 

Due in: @| 20 & [Minutes =i’ |: 00-00 

Time schedule: @ (use default) v 

Timezone: © (use default) v 
Vv 


Holiday schedule: @ (use default) 


ne Task Header 


__d. Save your work. 
When you demonstrate viewing work items later in this exercise, the different priority settings 
are displayed. 


Part 3: Demonstrate the Review Needed path 


During this playback session, you demonstrate the process, following various paths that flow from 
the exclusive gateways in the processes, and demonstrate tasks that are assigned. 


You accomplish a process playback session just as you would do when you seek consensus to 
move the project to the next playback phase. You log in as different users of the process to 
demonstrate tasks that different users accomplish in the process, demonstrating coaches that you 


created in the current playback phase. 
__ 1. Log on to the Process Portal. 
__a. Maximize the IBM Process Center Quick Start browser window from the Windows 
taskbar. 
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Exercise 7. Playback 1: Conducting the Playback session 


__b. Click the Process Portal link. 


Process application consoles & tools 


Create, manage, share, and test high-level containers such as process applications and toolkits. 
Process Center Console 


Test and administer the business user interface for completing tasks. 


If prompted, log in with authori as the user ID and passwOrd as the password. 


Sign in to Business Automation Workflow 


Username 


Password 
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Exercise 7. Playback 1: Conducting the Playback session 


__ 2. Complete the first activity, Submit Hiring Request, in the Process Portal. 


__a._ Inthe left frame, click Hiring Request Process to start an instance of the process. 


© Copyright IBM Corp. 2019 


author 


Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Work 
| Processes 


w] Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


Request Process 
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Exercise 7. Playback 1: Conducting the Playback session 


@ Troubleshooting 


If the library is not displayed, click the Main Menu icon on the left side of the Work tab. 


__b. A notice is displayed to indicate that the process is started. 


You received a new task titled Step: Submit Hiring 
Request 


The first task starts automatically in the portal because you assigned the first task to 
Lane and Last User. A window is displayed with the human service coach. 


c. Click the Recruiting Details tab, and select the New Position check box so that it 
follows the Review Needed path. Click Submit. 


Requisition Details Position Details [Recruingdetis | Compensation Details Department Details 


Recruiting Details 


C) Multiple Employees Needed 


C) New Position 
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Exercise 7. Playback 1: Conducting the Playback session 


__ 3. View the task that is assigned to the next activity, Approve New Hire Request, in the 
process. 


__a._ Inthe Library click Processes. 


author1 


Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Work 


Processes 


w] Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


tp Hiring Request Process 


__b. The Processes page opens. Click Hiring Request Process. 


'Q GE a search filter 2) Active | Completed 


-:) Hiring Request Process:203 |~ Due: March 20, 2019 7:39 PM 


Created: March 20, 2019 11:39 AM 


Showing 1 out of 1 results 


The process instance ID is the number next to the name of the process. The process 
instance ID can be different in your environment. If you have more than one instance, 
click the one with the highest instance number (the number after the colon). 
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Exercise 7. Playback 1: Conducting the Playback session 


__c. The process tab displays data about the instance. The bottom section that is labeled 


Tasks shows the next incomplete task in the process. Do NOT click the task. This task 
is assigned to the General Managers team. 


Y Data 


No details found. 


Vv Documents Q CG Y Tasks 
No documents or folders were found Open | Completed 
at this level. 


© step: Approve New Hire Request [> 
Due: March 20, 2019 12:45 PM 


4B} Genera! Managers 


__d. On the right, the creation date and the process due date are shown, along with a 


timeline that shows the current duration of the instance. Click the Stream area to view 
the actions that occur for this instance. 


Created Due & 
Mar 20, 2019 Mar 20, 2019 
11:39 AM p39 PM 


Activities 
Filter 


Ready | !n Progress | Completed | All 


No activities were found. 
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Exercise 7. Playback 1: Conducting the Playback session 


__e. To add to the stream, type Please approve into the stream field and click Post. Your 
comment appears as the most recent entry in the stream. 


Created Due & 
Mar 20, 2019 Mar 20, 2019 
11:39 a 7:39 PM 
l 
Stream 


| Please approve | 


Step: Approve New Hire Request task 
was created (currently assigned to 
General Managers) 

March 20. 2019 11:45 AM 


authori completed the Step: Submit 
Hiring Request task. 


Open | Comp! 


|20, 2019 12:45 Pt 
be General Manage 


4 


Show audit trail 
March 20. 2019 11:45 AM 


Step: Submit Hiring Request task was 
claimed (currently assigned to author?) 
March 20. 2019 11:39 AM 


Step: Submit Hiring Request task was 
created (currently assianed to author1) ~ 


__f. Click the GANTT CHART icon in the upper-right corner to go to the Gantt chart view. 


sd 
REFRESH GANTT CHART 


The Ganit chart is part of the Process Performance tab. When you click the link, you 
open the Process Performance > Instance Details page for the process instance. Wait 
for a few seconds as the loading of the page might take some time. You review the Gantt 
Chart later in this exercise after completing some activities. For now, you review the 
model and where you are at in the process. 
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Exercise 7. Playback 1: Conducting the Playback session 


__g. Click the Diagram tab for a model view of the same process instance. 


a 
Gantt View Diagram 


h. The model view of the process instance is displayed. 


Hiring Request Process 


i 


Submit Hiring 
Request \ Review Mt Needed 


Is Position 


Hiring Manager 


Approve New 
Hire Request 


General Manager 


This view shows the process with the Approve New Hire Request task that is highlighted for the 
Review needed path, and in the next part of this exercise you work on the Review not needed 
path. 


__ 4. Complete the Approve New Hire Request activity. 


__a._ Inthe library, click Log Out to log out of the Process Portal. 


author1 


Edit Profile 
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Exercise 7. Playback 1: Conducting the Playback session 


__b. Login to the Process Portal with the User name user1, Password passw0rd, and 


Business 
Automation 
Workflow 


Sign in to Business Automation Workflow 


click Continue. 


Username 


userl 


Password 


__c. A task is in the inbox for the Hiring Request Process process. The task stopped at the 
Approve New Hire Request activity. Notice that the task is assigned to the General 
Managers team, of which user1 is a member. Click the Step: Approve New Hire 
Request task. Depending on the amount of time spent, your task might be either On 
Track, At Risk, or Overdue. 


1 On Track 
Total 
0 At Risk 


0 Overdue 


Enter search text Of] ©& 


Step: Approve New Hire Request 


pre y MmEeyuveeoe Privecoo.cvy 
General Managers 
Due: Mar 20, 2019, 12:45:57 PM 

> 


Open 
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Exercise 7. Playback 1: Conducting the Playback session 


__d. Click Claim Task, and the task is assigned to you. 


Claim Task 


Step: Approve New Hire Request 
= Hiring Request Process:203 


General Managers 
Mar 20, 2019, 12:45:57 PM 
> 


This task is still unclaimed. When you open this task, it will be assigned to you. 


E] Don't show me this message again. 


Cancel Claim Task 


e. Ahuman service coach is displayed for the Approve New Hire Request activity. 
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Exercise 7. Playback 1: Conducting the Playback session 


__f. Drag the size of the browser window to display all tabs. 


Step: Approve New Hire Request 


Position Details Recruiting Details Compensation Details Department Details 


Requisition Details 


Requisition Number 


ee 7 


Requester 


——————————— 


Date Details 


Date Of Request 


Date Position Available 


Hiring Comments 


___g. Enter any data in the fields and complete this task by clicking Submit in the human task 
service. 


h. Click the Main Menu icon, if necessary, to open the library. 


0 On Track 
Total 0 At Risk 


0 Overdue 


Open 


i. Click Processes in the library. 
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Exercise 7. Playback 1: Conducting the Playback session 


__j. Click the Hiring Request Process instance with the same instance ID you worked on in 
the last step. The next task is assigned to author1. Click the task and you get a 
message stating “You are not authorized to see the details of this task.” 


Y Data 
No details found. Ey 

Created Due 
Mar 20, 2019 Mar 20, 2019 
11:39 a r 20 AM 

VY Documents Q GC Y Tasks Activities 

No documents or folders were found Open | Completed Filter 

at this level. : 40 5 

@ step: complete Hire Request | ue laren seas Ready | In Progress | Completed |All 
No activities were found. 


You are not authorized to see the details of the task. 


This would be the place to start the discussion around task status tracking. This task 
shows as overdue due to the 1-minute time out you configured earlier. If the task is not 
overdue, wait one minute and refresh the page (F5). 


k. Log out of the Process Portal. 


User 1 


Edit Profile 


rd) Note 


If Log Out is not displayed, click the Main Menu icon on the left side. 


=| 
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Exercise 7. Playback 1: Conducting the Playback session 


Part 4: Demonstrate the Review Not Needed path 


Now that you demonstrated the Review Needed path, this next part of the playback demonstrates 
the Review Not Needed path. It follows the same approach where you simulate the real-world 
experience of the different users inside the process as they log on to the portal and complete their 
tasks inside the process. 


__ 1. Show the process as it follows the Review Not Needed path, and create an instance to test 
the “existing position” scenario. 


a. Log into the Process Portal with authori as the User name and passw0rd as the 
Password. 


The incomplete step (Complete Hire Request) from the prior path shows up in the Work 
page. 
b. Create an instance of the Hiring Request Process by clicking the link in the Launch 


section. 
» « author1 
Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Work 
| Processes 


w Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


ye Hiring Request Process 


__c. You immediately see in a dialog box that you received a new task. A window is 
displayed with the human service coach. 
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Exercise 7. Playback 1: Conducting the Playback session 
__d. Click the Recruiting Details tab, and ensure that the New Position check box is 
cleared so that it follows the Review Not Needed path. 


Requisition Details Position Details Compensation Details Department Details 


Recruiting Details 


(1) Multiple Employees Needed 


2 New Position 


__e. Enter any data for the other fields and click Submit. 
You now have two items on your Work page. 


___2. Complete the process. 
__a._ Inthe library, click Processes. 


__b. Click the process with the highest process instance ID. Your process instances are 
highlighted in green, yellow, or red to reflect their due date status (On Track, At Risk, 


Overdue). 
°Q GE a search filter Active | Completed 
2) Hiring Request Process:203 ° r Due: March 20, 2019 2:30 AM 
Created: March 20, 2019 11:39 AM 


2) Hiring Request Process:204 | 1” Due: March 21, 2019 12:40 AM 


Created: Marcn 2U, 2U19 4:40 FM 


Showing 2 out of 2 results 
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Exercise 7. Playback 1: Conducting the Playback session 


__c._ This time, the process follows the Review Not Needed path. Instead of passing to 
Approve New Hire Request, the process steps through the Approve Hire Request 
linked process. Click GANTT CHART, and then click Diagram to view the process 


diagram. 
z 
‘Suom Hiring 
\ew/ Request > Revewty: Nesaes 
Sar Is PopRion 
New 
Approve New 
pire Request 


__d._ Click the link at the top to return to the Task. 


ee 


Hiring Request Process-204 > 


Hiring Request Process:204 


_ Gantt View Diagram 


__e. Click the Step: Check Hire Request task link. Recall this is the first task for the linked 


process. 
Vv Documents Q C Y Tasks 
Approve Hire Requ... '* Open | Completed 


author? 4:43 PM : . ; P 
_ © Step: Check Hire Request Due: March 20, 2019 5:43 PM 
Assigned to author? 


Retrieved items: 1 
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Exercise 7. Playback 1: Conducting the Playback session 


f. You are presented with the default user interface because you did not create a coach for 
this task. Click the Details tab to view details regarding the process instance. Click Done 
to complete the task. 


Step: Check Hire Request 


Overview Details 


This is a sample coach for the following activii Step: Check Hire Request 


__g. Now the process moves to the next task. Click Step: Override Hire Request. 


Vv Documents Q C Y Tasks 
Approve Hire Requ... | Open | Completed 
thor? 4:43 PM _ > 
— ©) step: override Hire Request| ~) 
Retrieved items: 1 Due: March 20, 2019 6:13 PM 


4&p All Users 


__h. Click Claim Task. 


x) 


Claim Task 


~ This taskis still unclaimed. When you open this task, it will be assigned to you. 


PM [_] Don't show me this message again 


__i. Click Done to complete the task. 


__j. The process now moves to Step: Review Posting. 
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Exercise 7. Playback 1: Conducting the Playback session 


k. Click the GANTT CHART icon on the upper-right corner of the window. Wait for few 
seconds to load the page. 


i lias 


REFRESH GANTT CHART 


|. Click the Diagram tab for a model view of the same process instance. 


Gantt View Diagram 
Zoom 


} 
| Hiring Request Process 


sees : Approve Hire 
[ea ‘| Request | > 
; Is Request 


Compliant 


fag 


| 


This time, the process follows the Review Not Needed path. Instead of passing to Approve New 
Hire Request, the process stepped through the Approve Hire Request linked process, through the 
Is Request Compliant gateway, and then to the Review Posting activity. The process followed a 
different path from the first instance, which demonstrates that the Is Position New gateway and 
process flow data are working correctly when driven by business data on a coach. If the Complete 
Hire Request activity is active instead of the Review Posting activity, verify you configured the Is 
Request Compliant gateway correctly. 


Part 5: Demonstrate activity tracking 


Now that the two processes have arrived at the activities that you changed settings for, you can 
continue the conversation around priority tracking and activity timeouts. It is a common practice to 
create mock scenarios when performing playbacks to demonstrate specific functionality. In this 


© Copyright IBM Corp. 2019 7-20 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 7. Playback 1: Conducting the Playback session 


case, you demonstrate how Process Portal flags activities that are highest priority and those that 
have passed their due date. 


__ 1. Display the status of the Review Posting activity in the Gantt chart. 

a. Click the Gantt View tab. 

b. Use the Zoom control to zoom out so you can see the prior activities. 
c. Mouse over the prior activity to display the name of the task. 


4/1/19 4/1/19 4/1/19 4/ 


10:14 AM 10:19 AM 10:24 AM 10:29 AM 


Today 


werride Hire Request 


d. This chart displays the time that it took to complete each task. Your chart might look 
different depending on the amount of time that is spent on each activity. In the Gantt 
chart, four activities are displayed. Roll the mouse over the other three completed 
activities to display their names. 


e. The first three activities were completed on time. The Review Posting activity is not 
complete. Depending on the amount of time spent, the Review Posting activity might 
also be past due. In the screen capture, the activity is displayed in yellow because it is at 
risk of becoming overdue. Click the Review Posting activity to view more details. 


f. Apop-up window displays more details regarding the Review Posting activity. 
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__g. Roll the mouse over the flag. The setting that you configured earlier is displayed: Very 
high. 


Review Posting ~ 


Assigned To: Unassigned 


Started: March 29, 2019 6:29 PM 
Due: March 29, 2019 6:49 PM 


Open Task [4 


__h. Click the red “x” to exit the pop-up. 
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Exercise 7. Playback 1: Conducting the Playback session 


___2. Display the status of the Complete Hire Request activity in the Gantt chart. 


__a._ Inthe Library click Processes. 


author1 
Edit Profile Log Out 
Dashboards Vv 


Create Saved Search 


Work 


| 
rocesses 


w] Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


tp Hiring Request Process 


__b. Click the earlier process (the process with the smaller process instance ID). 


__c. Click Gantt Chart. 


Hiring Request Process:278 > 
Hiring Request Process:278.~ 
4/41 


4/1119 
10:28 AM 10:4 


__d. Use the Zoom control to zoom out as necessary to view all activities. 
ie) a y % 
RESET SAE PROCESS OUE BATCH MODIFY 


4/1/19 


4/1/19 
10:19 AM 


10:10 AM 


Complete Hire Request 


Today 


7-23 
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Exercise 7. Playback 1: Conducting the Playback session 


e. The Complete Hire Request activity is highlighted in red, depicting it is past due. Click 
the Complete Hire Request activity to view more details. 


f. Roll the mouse over the flag. The default setting you configured earlier is displayed: 
Medium. 


__g. Click the red “x” to exit the pop-up. 
___3. Demonstrate the status of the activities on the Work page. 


__h._ Click the Main Menu icon to return to the Library. To display an activity on track, create 
an instance of the Hiring Request Process by clicking the link in the Launch section. 


By author1 
Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Work 
| Processes 


w Process Performance 
44% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


a Hiring Request Process 
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Exercise 7. Playback 1: Conducting the Playback session 


i. Donot complete the task. Click the Main Menu icon to return to the Library. Click Work 
to return to the Work page. 


author 1 


Edit Profile Log Out 


Dashboards Vv 


Create Saved Search 


Processes 


w] Process Performance 
43% Team Performance 


Launch 


Advanced HR Open New 
Position 


& Discover BPM UI 


we Hiring Request Process 


__j. You now have three work items displayed. 
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k. Mouse over the priority and status icons to display their textual representation. For the 
purposes of the demonstration, there is no need to complete the activities. The project 
team agrees the priority and status functionality meets their needs. The next step is to 
create a toolkit, create a snapshot, and export the process application. 


author’ 


Edit Profile Log Out 


Dashboards 
Step: Complete Hire Request 


Create Saved Search Hiring Request Process:276 
Due: Apr 1, 2019, 10:04:33 AM 


Step: Review Posting 


Work 
Processes Hiring Request Process:278 
All Users 


wi] Process Performance i Due: Apr 1, 2019, 10:30:33 AM 


cage) erry elidel 5 Step: Submit Hiring Request 
Hiring Request Process:279 
Launch Due: Apr 1, 2019, 11:44:24 AM 


The status of your work items might vary depending on the timing. 


ia) Reminder 


In this course, you did not implement all the coaches for the sake of brevity. In a real-world situation, 
one of the requirements to move to Playback 3 is that all the coaches are implemented in the 
process and all of them have the final presentation elements in place (CSS and JS, for example). 


Part 6: Reset the environment 


When demonstrating mock scenarios, it is important to reset the environment back to the defaults 
before moving on. 


__ 1. Reset the timeout value for the Complete Hire Request activity. 
__a. Return to Process Designer and log in as author1. 


__b. Open the Hiring Request Process unless it is already open. 
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__c. Click the Complete Hire Request activity. 


—® Approve Hire... | <> 


c 
1c] 
Is Request Request Compliant 
Compliant 
¥ 
9 
co 
Request Canceled Review 
Posting 


_ Complete Hire 
Request 


__d. Inthe Priority Settings section of the Implementation properties at the bottom, set the 
activity to be due in 1 hour. 


Y Priority Settings 


Priority: @ Normal (default) v 
Due in: @ 1 & 00:00 

Time schedule: WwW (use ceTaull) v 
Timezone: @ use default) v 
Holiday schedule: @ (use default) v 


nt Task Header 


___ 2. Reset the priority and timeout values for the Review Posting activity. 
a. Click the Review Posting activity. 


b. Inthe Priority Settings section of the Implementation properties at the bottom, select 
Normal for the Priority setting. 


c. Set the activity to be due in 1 hour. 


d. Save your work. 
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Part 7: Create the Hiring Requisition Toolkit and take a snapshot 


Now you have numerous assets, some of which might be useful to other developers. Create a 
toolkit from the assets you created as part of the process application HR Recruitment Processes. 


A toolkit is a collection of assets that are shared between process apps or other toolkits during 
development. Attentive application of toolkits is an efficient method for managing the reusability and 
compartmentalization of project assets. 


__ 1. Create the Hiring Requisition Toolkit 


__a. Click the View the Workflow Center icon in the upper-right corner of Process Designer. 


Admin 


Sort By: Recently Updated |» | All | wW Favorites | Archived 


*F Create New 


#{& HR Recruitment Process (HRR) 1” $< Process App 

Last updated on 3/15/19 by author’ z import Process App 
{5 Performance (SYSPERFDB) ‘” < ge: 9 Download desktop 

Last updated on 2/3/19 by author! Process Designer 

An (deprecated) 

#f% Process Portal (SYSRP) © €° eee 

Last updated on 2/3/19 by author 
{5 Heritage Process Portal (deprecated) (TWP) a a 

eo 7 > 3 ~ K : 
Last updated on 2/3/19 by author1 pt | Launch Getting 
7 Started 

{5 Procurement Sample (STPPS1) © = 


Last updated on 2/1/19 by author1 : _ (?) Process Applications 


{5 Hiring Sample Advanced (HSAV1) © 


Last updated on 2/1/19 by author! 


Process applications are 
containers in the Workflow 
Center repository for the 
process models and 
supporting implementations 
created in IBM Process 
Designer. Ordinarily, a 
process application includes 
process models, the services 
to handle implementation of 
activities and integration with 
other systems, and any other 
assets required to run the 
processes 


PA 


{5 Discover BPM UI Sample (DBPMUIS) 7 © 


Last updated on 2/1/19 by author 


oA 


{5 Hiring Sample (HSS) 


Last updated on 2/1/19 by author 


PA 


Managing process 
applications 
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__c. Click Create New Toolkit on the right side of the Workflow Center console. 


+ Create New Toolkit 


& import Toolkit 


$* Download desktop Process Designer 
(deprecated) 


Learn more 


d. Enter the name for the toolkit: Hiring Requisition Toolkit 
e. Enter the toolkit acronym: HRT 


f. Enter a brief description: This toolkit contains all common artifacts that are 
associated with the HR Recruitment Processes. 


Uncheck the Open in Process Designer check box 
h. Click Create. 


Create New Toolkit 


Toolkit Name: 

Hiring Requisition Toolkit 
Acronym: 

HRT 

Documentation: 


Bir \ Ul rm VE 


This toolkit contains all common artifacts that are associated with the HR Recruitment Processes. 


Clopen in Process Designer 
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Exercise 7. Playback 1: Conducting the Playback session 


i. The Hiring Requisition Toolkit (HRT) shows up under the Toolkits tab. 


Process Apps Toolkits Servers 


Sort By: Recently Updated ~| All | W Favorites 


ro Hiring Requisition Toolkit (HRT) 1” 


Last updated on 3/21/19 by author 


__ 2. Move the client-side human service into the toolkit and create a snapshot. 


__a. Click the Process Apps tab. Open the HR Recruitment Processes (HRR) process 
application in the Process Designer by clicking Open in Designer. 


Process Apps Toolkits Servers Admin | Preferences | Logout 


Sort By: Recently Updated |! All | we Favorites | Archived 


¢{§ HR Recruitment Process (HRR) 1” Bos aoe 
@ Open in Designer 
Last updated on 3/15/19 by suthor1 


__b. Inthe library, right-click the User Interface > Hiring Form client-side human service. 
c. Click Move Item to > Other Toolkit. 


User Interface 7 


HR Recruitment Process 


Processes Client-Side Human Service 
@ Hiring! Open 
User Interface Favorite aT) 
@ Hiringi Tags . | 
Services Revert... Is| 
Copy to tip 
Events Copy item to r 
Move item to > | otherProcess App... | 
Rename 
xX Delete | | 


Hiring Requisition Toolkit 
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e. Keep the defaults and click MOVE. The order of the dependent artifacts may be different 
than in the screen capture. 


Move Artifacts to Toolkit: Hiring Requisition Toolkit 


Select artifacts to move: 
Selected artifacts will be moved. 


& Hiring Form 


Select dependent artifacts to move: 
Broken references might occur if you do not move dependent artifacts. 


@ HiringRequisition 

@ CompensationDetails 
@ DepartmentDetails 

@ Position 

@ RectuitingDetails 


Artifacts with dependencies on selected artifacts: 
Selected items will be moved. Items that are not moved might cause broken references. 


(og) Hiring Request Process 4) 
(og) ‘Approve Hire Request +) 


MOVE CANCEL 
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f. All the dependent assets are also moved into the toolkit to include the variables that the 
client-side human service depends on. A dependency on the toolkit is automatically 
created inside the process application. In the Library section, expand Toolkits to see the 
Hiring Requisition Toolkit. 


Files 


Toolkits 


System Data (8.6.0.0) 


UI Toolkit (8.6.0.0) 


Smart Folders 


__g. Return to the Worfklow Center console. 


a 2 c_ 2 [al 


__h. Click the Toolkits tab. 
__i. Click the toolkit Hiring Requisition Toolkit (HRT). 


Process Apps Toolkits Servers | Preferences| Logout “? 


Sort By: Recently Updated |~| All | w Favorites | Subscriptions | Shared | Archiv 


fae Hiring Requisition Toolkit (HRT) 1 


$ Open in Designer 


Last updated on 3/21/19 by suthor1 


__j. You notice a snapshot has already been created. This was done automatically when you 
moved the assets to the Toolkit. 


GSB Move 1 (M1) \* (New) 


Crested on 3/21/19 by author1 
P Where used 


k. Click Create New Snapshot on the right side. 


Recall that a snapshot captures the state of the library items within a process application 
or toolkit at a specific point in time. Snapshots usually represent a milestone or are used 
for playbacks or for installation. Since Playback 1 is now complete, it is a good time to 
take a snapshot. 
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__|. Name the snapshot Baseline and add a description: This is the baseline 
snapshot of the Hiring Requisition Toolkit. Then, click Create. 


Create New Snapshot 


Snapshot Name: 
Baseline 
Documentation: 


Bi i\uf rn © 


This is the baseline snapshot of the Hiring Requisition Toolkit 


__m. The snapshot Baseline is created. 


9 Current 


Last changed on 3/21/19 by author’ 
(Not Used) 


P Validation Errors and Warnings By Type 


£9 Baseline (B) * (New) 


Created on 3/21/19 by author’ 
P Where used: 


EeR Move 1 (M1) * (New) 
Crested on 3/21/19 by author 
P Where used: 


___ 3. Update the toolkit version on the process application. 


Design toolkit hierarchies to avoid mutual dependencies by factoring out common content 
into its own toolkit so that the other toolkits can refer to it independently. 
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If you update the dependency on a child toolkit, you need to take a new snapshot of the 
parent toolkit (or process application) for the change to be effective for whoever uses that 
toolkit. This can lead to a race situation with mutually dependent toolkits. 


__a. Click the Process Apps tab. Open the HR Recruitment Processes (HRR) process 
application in the Process Designer by clicking Open in Designer. 


Toolkits Servers Admin | Preferences|Loaout “2 (¥ 


Process Apps 
HR Recruitment Process (HRR) ‘ 
“ts | ( ) $ Open in Designer 
Last updated on 3/15/19 by suthor1 


Sort By: Recently Updated | All | W Favorites | Archived 


__b. When you return to the process application, Expand the Toolkits category in the Library 
section. The Hiring Request Toolkit shows a warning because the process 
application is not pointing to the most recent snapshotted version. 


Toolkits 


System Data (8.6.0.0) 


UI Toolkit (8.6.0.0) 


__c. Click the arrow next to the Toolkit and select Upgrade Dependency to (Baseline). 


Toolkits m,) 
Uparade Dependency to (Baseline) 


Hiring Requisition Toolkit (Move 1) A Ignore Version (Baseline) of Dependency 
Change Version of Dependency 


>< Remove Dependency 
Data Mapping Name: 


Le Processes Pre & Post ID: 
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__d. Inthe Toolkits category, verify that the Hiring Requisition Toolkit (Baseline) isnow linked 
to the HR Recruitment Processes process application and that the warning is gone. 


Toolkits 


System Data (8.6.0.0) 


UI Toolkit (8.6.0.0) 


You have completed this exercise. 
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Part 8: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__c. Enter Exercise 7 solution for the name. 
__d. Click Create. 


__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
You can only export snapshots. 


__a. Click Export next to the snapshot. 


__b. Inthe Export Process App window, click Export. It might take a minute or two to 
generate the . twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

( IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


#2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


2 Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated +» All | W Favorites | Archived 


e. Click Delete. 


Logged in as author’ (author!) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


Sree aoa 


__f. Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


__g. Click All. Note that the HR Recruitment Process is no longer listed. 
__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 


__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit (HRT) toolkit. 
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__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) History Governance 


__c._ Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 


@ View Archived Tracks 


d. Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 
delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


e. Click Toolkits again and this time click the Archived link. 


Logged in as author’ (author1)| Preferences | Logout 


Sort By: Recently Updated ~ All | w Favorites | Subscriptions | Shared 


__f. Click Delete. 


Logged in as author? (author!) | Preferences | Logout 


Sort By: Recently Updated ~ All | w Favorites | Subscriptions | Shared | Archived 


__g._ Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h. Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


In this exercise, you completed Playback 1. You conducted a playback session demonstrating two 
unique process scenarios. You used the Process Portal to demonstrate the playback from the user 
point-of-view. After completing Playback 1, you created a snapshot for the toolkit and process 
application and then exported the process application. 
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This completes Playback 1. The process, data, and coaches have now all been approved to move 
on to the next playback. Once all of these components have been verified, concentration can be 
paid to integration with other systems, which is covered in the next playback. 


End of exercise 
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Exercise 8. Playback 2: Integrations 


Estimated time 


01:30 


Overview 


This exercise covers how to create implementation assets to support Playback 2: integrations. 


Objectives 


After completing this exercise, you should be able to: 
e Create a decision service 
¢ Create and configure a UCA 
¢ Start a process with a message start event 
e Use tagging to organize assets 
* Query a database to obtain information and populate a list variable 
¢ Create environment variables (ENVs) and exposed process variables (EPVs) 


¢ Change a text control to a single select control 


Introduction 


In Playback 2: Integrations, you implement the process interactions and integrations so the process 
can have all the functions that are needed to complete any process activity. Not all the functions are 
developed within the process application when it comes to user interactions. Some of the business 
data can be found, for instance, in systems within an organization. So it is important to be able to 
retrieve the data, and that is why integrations play a vital role in having a full and robust process 
application. 


Other process interactions involve events within the process model. In this stage of Playback 2: 
Integrations, you implement those system activities that set business data and process flow data 
with rules and automations. These intermediate events or start events might need unique event 
handlers, such as listeners for messages that trigger an event. In Playback 2, you implement, test, 
and finalize all remaining process application interactions. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 7 process application solution that is required to start 
exercise 8. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


*} Create New Process App 
& Import Process App 


$= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select HR_Recruitment_Process - 
Exercise_7_solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, make sure that the Open in Process Designer 
option is not selected, and click Import. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 
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h. Click Hiring Requisition Toolkit (HRT) and then click Manage. 


i. Click Allow users to update toolkit. This is required for any updates to the toolkit. 
L_] Allow users to update toolkit 


__j. Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise. 


Allow users to update toolkit 


|_}] Allow uSefs to create tracks in this toolkit 
Why Tracks 


Part 2: Create a decision service 


The Hire Request business process is a candidate to include a decision service in the process flow. 
Decision services allow the business process to make routine decisions that are based on real 
business rules to speed up the process and eliminate user error. 


If the salary is not compliant, the criteria that they must use is to route hiring requisitions for 
administrator override. The salary compliance depends on the job level. Different job levels have 
different compliance ceilings. In the as-is process, a user decides. In the to-be process, a user was 
going to decide, but now they want the system to decide based on business rules. 


Your task is to implement that decision service in a process. You created the process model during 
Playbacks 0 and 1, and in Playback 2, you implement all the services. 


This exercise is long, so a break is included in the middle of the instructions. The instructions 

include some swapping back and forth and moving around different assets in the library. The 

sequence is intentionally set to simulate the steps that a developer takes when creating these 
assets, and reflects real-world development efforts. 


__1. Create a decision service. 
a. Click the Process Apps tab. 


b. Click the Open in Designer link next to the HR Recruitment Process (HRR) process 
application. 


c. Inthe library, click the (+) plus sign next to Services. Click Service Flow to create a 
service. 


© Copyright IBM Corp. 2019 8-3 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 8. Playback 2: Integrations 


__d. Name the service Salary Compliance Service and click FINISH. 


New Service Flow W 


A service flow lets you build, test, and run a set of services. Learn More 


Name: Salary Compliance Service 


Use as a team service: 


__ 2. Adda Business Action Language rule. 


__a. You are now in the new service. Expand the top activity and drag a Decision step from 
the service palette onto the canvas between the Start and End events. 
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__b. Name the Decision: Check Compliance 


Start Check End 


ia) Reminder 


You can rename artifacts two ways: either through the General > Common properties section, or 
by double-clicking the artifact and renaming it on the canvas. 


__c. Connect the start and end flows to the Check Compliance step. 


Overview Diagram Variables Decisions 


Start Check End 


Compliance 
__d. Straighten the flows. 
___3. Add variables to the service. 
__a. Click the Variables tab. 
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__b. Add an input and name the variable: compensation 


Overview Diagram Variables Decisions 


VY Variables (Q. Type to filter 


vy @ Input 
© 
® 
© 
© 


compensation (String) 


@ Output 
@ Private 
a Exposed Process Variables 


© Localization Resources 


__c. Click Select next to the Variable type. To filter the variable type list, type: Com 


and then Click the variable type CompensationDetails. 


Select Library ttem 


Business Object 


__d. Add asecond input variable named position of type Position. 


| Q. Type to filter 


Variables 


® s 


vy @ Input 
>» @ compensation (CompensationDetails) 
@ Output 
@ Private 
a Exposed Process Variables 
@ Localization Resources 


OOO® 
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__e. Add an output variable: isCompliant (String). 


Y Variables (Q Type to filter 


® 


vy @ Input 
» ® compensation (CompensationDetails) 
> @ position (Position) 
vy @ Output 
@ Private 
a Exposed Process Variables 


OOO © 


(@ Localization Resources 


__f. Save your changes. 
__ 4. Add the rules for the service. 


__a. Click the Decisions tab. 


Overview Diagram 
Y Variables Q. Type to filter 


__b. Click the Check Compliance BAL rule on the left. 


Overview Diagram Variables Decisions 


Check Compliance —- 
| 


Po CS 


if <condition> then <action>; 


A default rule is added to the BAL rule editor. The condition and action options are editable. If you 
click either option, an editor is displayed to assist you with writing the rule. As is the case with the 
JavaScript editor, you can also use content assist (Ctrl+Space). 


The BAL rule is a simple set of if-then statements. In this example, if the salary is over or under a 
threshold, it is not compliant. Otherwise, it is compliant. The threshold levels are: 


¢ Associate. Minimum salary: 40,000, maximum: 60,000 


e¢ Manager. Minimum salary: 50,000, maximum: 75,000 


© Copyright IBM Corp. 2019 8-7 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 8. Playback 2: Integrations 


¢ Director. Minimum salary: 70,000, maximum: 95,000 


¢ President. Minimum salary: 100,000, maximum: 150,000 


@ Troubleshooting 


The lab environment might occasionally cause unexpected behavior when using content assist. If 
the content assist window ever disappears, press the spacebar to see the content assist window 
display again. 


Alternatively, if you are having difficulty with the content assist, you can copy and paste the rules 
text that is provided in the file BAL Rules.txt atthe location: C:\labfiles\Support files\Ex8 


First, you build the condition, then you build the action to be taken when the condition is met. 


Build the condition. 


__c. To build the condition, click the <condition> statement for your rule, and select the 
following rule piece: 


the salary to offer of <a compensation details> 


ca 
if Fees then <action=; 


EQ x 
w tne bonus amount or <a Compensation aetals> 


°@ the job description of <a position> 
°@ the job level of <a position> 
°@ the job title of <a position> 
°@ the length of <a string> 
°@ the num direct reports of <a position> 
= the number of <term> 
E °@ the number of elements in <obiects> 
(= there are <a number> 
there are at least <a number> 
= there are at most <a number> 
= there are less than <a number> 
= there are more than <a number> 
= there is at least one <term> a 
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__d. Adda space and use the content assist (Ctrl+Space) to add compensation 


# © |] 


ifthe salary to offer of then =<action=; 
iE Q 


® compensation 


__e. Use content assist to add the following: is between <min> 


2%] 


ifthe salary to offer of compensation |then <action>- 
Ez Q 
@ does not equal <a number> 
@ equals <a number> 
@ is <an object> 
@ is at least <a number> 
@ is at least <min> 
@ is at most <a number> 
@ is less than <a number> 
x] 1 Th, @ is more than <a number> 
@® is more than <min> 
a 1 Pees . 
@ js not <an object> 
@ is not one of <objects> 
@ is one of <objects> 
@ is strictly between <min> 


f. Use content assist to add: <number>. Immediately after being added, the number turns 
to 0. Enter 40000 then add a space. 


Use content assist to add and <max> 
h. Enter 60000 
i. Adda space and use content assist to add and <condition> 
__j. Usecontent assist to add the job level of <a position> 
k. Use content assist to add position 
|. Use content assist to add contains <a string> 
__m. Enter “Associate" 

Build the action. 


__n. Select the <action> statement of your rule, and select the following rule pieces: 


© Copyright IBM Corp. 2019 8-9 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 8. Playback 2: Integrations 


set <variable> 
isCompliant 

to <variable value> 
<string> 

nm. 

<space> 

else 

set <variable> 
isCompliant 

to <variable value> 
<string> 


no": 


ifthe salary to offer of compensation 

is between 40000 and 60000 and 

the job level of position contains “Associate” 
then set isCompliant to "1"; 

else set isCompliant to "0"; 


The BAL rule reads much like a natural sentence. You assign a value in the first rule, 
and the other rules below it evaluate. If one of the rules evaluates to true, then it 
overwrites the variable. 


0. Click the (+) plus symbol to create a second rule. 


¢% 
ifthe salary to offer of compensation 
is between 40000 and 60000 and 

the job level of position contains “Associate” 


then set isCompliant to "1"; 
else set isCompliant to "0": 
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__p. Build the next rule by using the previous method to flag the salary as non-compliant 
when it does not fall within the same range.Alternatively, if you are having difficulty with 
the content assist, you can copy and paste the rules text that is provided in the file BAL 
Rules.txt at the location: C: \labfiles\Support files\Exs8. Build the rule to read: 


if the job level of position contains "Manager" 

and all of the following conditions are true: 

- the salary to offer of compensation is more than 50000 
- the salary to offer of compensation is less than 75000 
then set isCompliant to "1"; 


¢ 

if the job level of position contains "Manager" 

and all of the following conditions are true : 

- the salary to offer of compensation is more than 50000 


- the salary to offer of compensation is less than 75000 
then set isCompliant to "1" ; 


__q. Continue with the third BAL rule. Copy and paste the prior rule and change the variables 
as required. 


if the job level of position contains "Director" 

and all of the following conditions are true: 

- the salary to offer of compensation is more than 70000 
- the salary to offer of compensation is less than 95000 
then set isCompliant to "1"; 


__r. Add the final rule. Copy and paste the prior rule and change the variables as required. 
if the job level of position contains "President" 
and all of the following conditions are true: 
- the salary to offer of compensation is more than 100000 


- the salary to offer of compensation is less than 150000 
then set isCompliant to "1"; 


ia) Reminder 


To avoid any errors, the rules text is provided in the file BAL Rules.txt at the location: 
C:\labfiles\Support files\Ex8 
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s. Change the position of the different rules to make the first rule you created the top rule, 
and each subsequent rule underneath the prior one by using the arrows on the right of 
each rule. You can start by scrolling to the rule for Associate and click the arrow to bring 


it to the top. 
¢ © |[B~] =) 
if the salary to offer of compensation si 


is between 40000 and 60000 and 

the job level of position contains “Associate” 
then set isCompliant to "1"; 

else set isCompliant to "0" ; 


Pe} i+} Le] 
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__t. Verify that all the four rules are created and are placed in the correct order. 


¢ © [+] 


ifthe salary to offer of compensation 

is between 40000 and 60000 and 

the job level of position contains “Associate” 
then set isCompliant to "1"; 

else set isCompliant to "0"; 


Y & [9] 


ifthe job level of position contains “Manager” 

and all of the following conditions are true: 

- the salary to offer of compensation is more than 50000 
- the salary to offer of compensation is less than 75000 
then set isCompliant to "1"; 


¢ © [+] 


ifthe job level of position contains “Director” 

and all of the following conditions are true: 

- the salary to offer of compensation is more than 70000 
- the salary to offer of compensation is less than 95000 
then set isCompliant to "1": 


¢ © [+] 


ifthe job level of position contains "President" 

and all of the following conditions are true: 

- the salary to offer of compensation is more than 100000 
- the salary to offer of compensation is less than 150000 
then set isCompliant to "1"; 


__ 5. Save your work. 
__6. Debug the service. 


To make sure that the rules are working as expected, debug your service by providing default 
values to the variables. 


__a. Switch to the Variables tab. 
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__b. Click the input variable compensation (CompensationDetails). Select the Has 
Default check box under the Default Value section on the right. 


Vv 


Variables LX Typetorite _ ) 


y @ Input 6) , 
> ®& compensation (CompensationDetails) [x] 


> © position (Position) 


y © Output 6) 


©@ isCompliant (String) 


@ Private @ 
a Exposed Process Variables @ 
Localization Resources @ 


Name: compensation 


Documentation: BIU | = 


Is list: a 
Variable type: ® CompensationDetails Hiring Requisition Toolkit 


Vv ___Default Value 
Has default: | 


lvar autoObject = new tw.object.toolkit.HRT.CompensationDetails(); 
2 autoObject.salaryToOffer = 4500.0; 

3 autoObject.bonusAmount = 4.0; 

4 autoObject 


Change the value for the variable salaryToOffer to 45000 .0 


Has default: !M 


4 autoObject 
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Y Default Value 


ea aa ant HRT. CompensationDetails( 


autoObject.salaryToOffer = 45000.@; 


2 GULOYVDJSCL.DONUSAMOUTIL = U.05 


8-14 


_d. 


_e. 


_f. 
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Click the input variable position (Position). Select Has Default under the Default Value 
section on the right. Enter "Associate" for the variable jobLevel: 


Default Value 
lvar autoObject = new tw.object.toolkit.HRT.Position(); 
2 autoObject.jobTitle = ""; 


RautaOhtert ainhNecrcrintian = ""+ 


Has default: 


5 autoUbject.numVDirectKeports = G; 
6 autoObject 


Save the service and click the Debug button at the top. 


authoiv () 


CREATE NEW (+) (elo 


Note that the view changes from the designer view to the inspector view. 


INSPECTOR 


# Salary Compliance Service v ® @ 
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__g. The debug window opens on the right to show information about the service. Expand 
the Data section on the bottom and verify that the default variables are assigned 
correctly. 


(>) Salary Compliance Service 


Instance ID: 53 
Process App: HR Recruitment Processes 
Status: Running 


Vv Locations 


© Check Compliance 


Vv Data 


— >) compensation(CompensationDetails) 
salaryToOffer(Decimal) 45,000 
bonusAmount(Decimal) 0 

[=] © position(Position) 
numDirectReports(Integer) 0 
jobTitle(String) <Empty> 
jobDescription(String) <Empty> 


jobLevel(String) Associate 


«> isCompliant(String) <Empty> 


__h. Click the Step Over icon on the top to test the first decision rule with the value for 
variable salaryToOffer as 45000 and the value for variable jobLevel as Associate. 


(>) Salary Compliance Service 
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i. The service executes the BAL rule, the service completes, and the status changes to 
Finished. The correct response with this set of inputs is that the request is compliant. 
Verify that you get an isCompliant variable value of 1 because for the Associate position 
the salary is in the range 40000 — 60000 and you tested with the value 45000, which 
makes this request compliant. 


v) Salary Compliance Service 


No actions were found. 


Instance ID: 53 
Process Ann” HR Recruitment Processes 


Status: Finished 


No locations were found. 


~ &) compensation(CompensationDetails) 
salaryToOffer(Decimal) 45,000 
bonusAmount(Decimal) 0 

— & position(Position) 
numDirectReports(Integer) 0 
jobTitle(String) <Empty> 
jobDescription(String) <Empty> 
jobLevel({String) Associate 


© isCompliant(String) 1 


__j. Click the Designer tab to return to the Designer view. 


INSPECTOR 


# Salary Compliance Service ~ ® @ ko 


__k. On the Variables tab, select the position (Position) input variable 
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__|. Change the value of the jobLevel variable to "Manager" and save the service. Switch 
to the Diagram tab and click the Debug button on the top. 


Y Default Value 


Has default: 


lvar autoObject = new tw.object.toolkit.HRT.Position(); 
2 autoObject.jobTitle = ""; 


— eee ee ee ee ee — 


6 autoObject 


m. The information window opens on the right. The token on the Check Compliance service 
step shows the next step in the service to be run. The token matches the step that is 
shown in the Locations section in the information window. 


Overview Variables Decisions 


© Salary Compliance 
Service 


& 
Check 


Compliance V Details 


aN Instance ID: 456 

eo, Process App: HR Recruitment 
Process 

D Status: Running 


VY Locations 


© Check Compliance 


__n. Expand the Data section and click the Run button on the top to run the service to 
completion. 


(>) Salary Compliance Service 


Vv Details 


The Step Over button runs a single step in the service where the token is located. The 
Run button runs the service until a coach is displayed or until the service completes. 
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__o. The service request is not compliant. Expand the business objects and verify that you 
get an isCompliant variable value of ©. This is because the salary for the Manager 
position is in the range 50000 - 75000 and you tested with salary 45000, which makes 
this request non-compliant. 


o) Salary Compliance 


Service 


No actions were found. 


Vv Details 


Instance ID: 55 
Process App: HR Recruitment Processes 
Status: Finished 


Vv Locations 


No locations were found. 


— >) compensation(CompensationDetails | 
salaryToOffer(Decimal) 45,000 


bonusAmount(Decimal) 0 

— e>> position(Position) 
numDirectReports(Integer) 0 
jobTitle(String) <Empty> 
jobDescription(String) <Empty> 


iohl evelfStrino) Mananer 


«> isCompliant(String) 0 
< > | 


__p. Return to the Designer view of Process Designer. 


__q. Click the Variables tab and clear the Has Default check box under the Default Value 
section for the input variables compensation (CompensationDetails) and position 
(Position). 

__fr. Save your changes. 


__ 7. Add the rule to the process. 


___a. Open the Approve Hire Request process. You might need to click the Library menu 
shown by three horizontal lines, then click Processes > Approve Hire Request. 
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__b. Select the Check Hire Request activity in the System lane. 


Not Compliant 


+O 


End Notification 


Check Hire 


Request ~ Compliant - 


Is Salary 
Compliant 


__c. Click the Implementation properties menu. 


General 
— Type: User Task ss 
Assignments 


Pre & Post v Implementation 


Tracking 
Implementation: —_@ Default Ul Human Sernice BPM UI 


Conditions 


__d. Change the activity type to Decision Task. 


General 


implementation Vv Activity Type 
Data Mapping - 
ype. | fj | Decision Task v 
L 


Tracking Delete task on completion: 
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__@. Click Select in the Implementation section. 


Y’ Activity Type 


Type: Decision Task wv 


Delete task on completion: CJ 


Y Implementation 
Implementation: <none> New... 


@ Information 


If you want to run an automated service that does not require routing, you must select the Delete 
task on completion check box. This option deletes the task from the system and the process 
inspector after the task completes. When you select this check box, the Process Server does not 
retain audit data for the task. By default, this check box is not selected. 


Deleting the task on completion from the task table in the database provides some performance 
advantages. However, in this case you do not select this option because you want to avoid losing 
some auditing data, including the details of when that system task executed and how long it took. 


__f. Select Salary Compliance Service. 


General 
implementation Y Activity Type 
Data Mappin : 
spi = Decision Task v 
Pre & Post 
Wackiog Delete task on completion: LJ 


Conditions Vv Implementation 
Implementation: #” Salary Compliance Service 


__ 8. Map the variables for the Check Hire Request activity. 
__a. Open the Data Mapping properties menu. 


__b. Enter tw. local. requisitionDetails.compensationDetails for the first input to 
map it with compensation. 
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__c. Enter tw.local.requisitionDetails.position for the second input to map it with 
position. 


Vv Input Mapping 


tw. local. requisitionDetails.compensationDetails &. > compensation (Compensation 
tw.local.requisitionDetails. position & > position (Position) 


__d. Enter tw.local.isCompliant for the output to map it with isCompliant. 


Y Output Mapping 


isCompliant (String) yY tw.local.isCompliant & 


Notice that you do not need to send the full requisitionDetails object into every activity. If a 
linked process or an activity needs only a small amount of data from the larger object, send 
in what is necessary. This approach helps the performance of your processes at run time. If 
you know that variables hold the same data, it also helps to name those variables the same 
across your processes because it helps with maintenance and troubleshooting. 


__@. Save your work. 
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Part 3: Implement a message start event 


A business requirement has been added specifying the process needs to automatically run every 
month. monthly. Now it is time to implement the process so an instance of the process can be 
initiated monthly. 


__1. Create a service to enable the undercover agent (UCA). 

a. Inthe library, click the (+) plus sign next to the Services menu. 
b. Click Service Flow. 

c. Name the service: Systematic Request ES 

d. Click FINISH. 


A service flow lets you build, test, and run a set of services. Learn More 


New Service Flow . M 


Name: Systematic RequestES 


Use as a team service: LC] 


__e. Click the Variables tab. Continuing from Part 1 of this exercise, create a 
requisitionDetails (HiringRequisition) input and output variable. 


Vv Variables 


vy @ Input 
> ® requisitionDetails (HiringRequisition) 
vy & Output 


>» & requisitionDetails (HiringRequisition) 


@ Private 
2 Exposed Process Variables 
Localization Resources 
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A CAUTION 


Make sure that any single variable that is passed in and out of a service is spelled the exact same 
for both fields. Remember, variable names ARE case-sensitive. If you have any differences in the 

variable names, then the system considers them two different variables. This error frustrates many 
developers when troubleshooting why your variable is not passing out the expected data. Copying 
and pasting variable names ensures that your variables are the exact same, and reduces problems 


that result from typographical errors. 


__f. Save your work. 
__ 2. Create a server script to initialize the variables and pass it out of the service. 


__a. Return to the Diagram tab. Expand the Activity selection and drag a server script from 
the palette onto the canvas. 


__b. Name the server script: Create Vars 


(ii 


Create Vars 
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___c¢. Create a server script to initialize the variables and pass it out of the service. In the 
Script properties menu, copy the script from the Script1.txt file that is located in 
the C:\labfiles\Support files\Ex8 folder. Optionally, you can enter the following 
script in the box: 


if (tw.local.requisitionDetails == null) { 
tw. local.requisitionDetails = new tw.object.HiringRequisition(); 


O — ze) a 


End 


Create Vars 


General i 


Implementation Y Script @) 


® Script —) Scriptlet 

Script P P 
Lif (tw.local.requisitionDetails == null) { 

Pre & Post 2tw.local.requisitionDetails = new tw.object.HiringRequisition(); 

3} 


__d. Connect the flows. 


[i 


( ® Create Vars “@) 


Start End 


__@. Save the service. 
__ 3. Create and enable an Undercover Agent. 


__a. Click the (+) plus sign next to Events, and click the Undercover Agent option. 
—— |) lH eh) ae | * | se | 


Services 


Events 


Teams © Event SuDscripton 


Data 
Ld 


© Copyright IBM Corp. 2019 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


8-25 


Exercise 8. Playback 2: Integrations 


__b. Name the UCA: Systematic Request 


Make sure that the Time Elapsed schedule type is selected. Click FINISH to complete 
the creation of the UCA. 


New Undercover Agent 


Undercover agents (UCAs) are started by an event and invoke a Process. 
UCAs pass data to the Process through an associated service or variable. 


Name: Systematic Request 


Schedule Type} | Time Elapsed 


FINISH CANCEL 


__c._ Inthe Details section of the UCA settings page, click Select next to Attached Service. 
Select the Systematic Request ES service. Verify that the Enabled check box is 
selected for the new undercover agent. 


re 


Queue Name: Async Queue 


v 
Attached Service: ra SystematicRequestES }| Select... 


Enabled: 


__d. Create the schedule according to the following script: 
Every month (all months) on the first Saturday at Midnight on the hour. 
Select all the months, then the First, Saturday, Midnight, and On the hour options. 
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This setting generally provides time for the purging service to complete over the 


weekend. 
| Undercover Agent 
| Name: Systematic Request Schedule Type: Time Elapsed 
Documentation: Event Marker: © Timer 


IIl| 
he 
ees Ie 
I'| 
I 
Ih 


Vv Time Schedule 


Queue Name: 


Attached Service: 


Enabled: 


v Parameter Mapping 


&} requisitionDetails (Hi... 


Async Queue 
#” Systematic Request ES 


January Monday Midnight aN A 
February Tuesday 41:00 am 5 past the hour 

March Wednesday 2:00 am 10 past the hour 

April Thursday 3:00 am 15 past the hour 

May Friday 4:00am 20 past the hour 

June 5:00 am 25 past the hour 

July Sunday 6:00 am 30 past the hour 

August 7:00 am 35 past the hour 
September 8:00 am 40 past the hour 
October 9:00 am v 45 past the hour v 


__@. Save your work. 


__ 4. Implement the Systematic Request start message event on the Hiring Request Process 


process. 


__a. Open the Hiring Request Process process.You might need to click the Library menu 
with the three horizontal lines, and then click Processes > Hiring Request Process. 
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__b. Drag a Start event from the palette to the process near the End event. 


A 

a. Review Or 

Request Canceled Posting a 
Start Event wW 
@y 

H L_} 

- lete Hi 
omplete Hire 
af Request ~O 


End 


Because a start event is already on the canvas, subsequent start events added to the 
canvas default to a Start message event. You can also expand the start event in the 
palette and drag a Start message event to the canvas to get the same result. 


__c. Rename the start message event to: Systematic Request Start 


a 
Review 
- Va ~ 
Request Canceled Posting (=) 
Systematic 
Request Start 
¥ 
a 
Complete Hire “@) 
Request 


End 
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__d. Connect Systematic Request Start to the Complete Hire Request activity. 


fe. 
Review 
Posting 
Systematic 
Request Start 


Request Canceled 


¥ 


Complete Hire 20) 
Request 


e 
ae 
End 


__@. Click the Systematic Request Start event, click the Implementation properties menu, 
and then click Select next to Attached message UCA. 


General 
Start Event Type 
implementation 


Data Mapping @ Message 


Pre & Post 
Event Properties 
Tracking 
Attached message UCA: — <pone> New... | 


__f. Select the Systematic Request UCA that you created for the activity. 
___g. Save your work. 

__5. Map the Systematic Request start event UCA outputs to the process variables. 
__a. Click the Data Mapping properties menu. 


__b. Inthe Output Mapping section, map the requisitionDetails output variable to the 
requisitionDetails (HiringRequisition) variable. 


General 


Implementation vy Output Mapping 
Data Mapping 
sition iis (Hi... > twiocal requisitionDetails 
Pre & Post 
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__c. Save your work. 
__ 6. Test the UCA. 


__a. Open the Systematic Request UCA listed in the Events section of the library. 
Type v Event 


Processes Undercover Agent ra) 


‘wi Systematic Request 


User Interface 


Services 


Events 


b. Click Run now in the Scheduler section. 


vy Scheduler 


Schedule Type: Time Elapsed 
Event Marker: ( Timer 


__c. Adialog box is displayed, which indicates that the UCA is scheduled for immediate 
execution. Click OK. 


ks Information 


The UCA has been scheduled for immediate execution. 


__d. Click the INSPECTOR view tab. 


DESIGNER 


~~ Systematic Request v ® @ kl 
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e. At the top, click the first icon to search process instances. 


f. Onthe left, underneath the search filter criteria, click Search to view all the instances of 
all the processes in the Process Center Server. 


__g._ If everything was successful, the UCA and Message Start event created a Hiring 
Request Process instance. The instance that you created when you ran the test is the 
highest numbered instance that is shown in the right frame. This window shows all the 
instances that ran in Process Designer and their status, although your environment 
might not match what you see in this screen capture. 


“a 
Search Q Select shown instances | Select ail instances | Clear selection 


Filter process instances b 
P ” P Hiring Request Process:253 *€ Hiring Request Process 


= Status Last modified Apr 28, 2019 Due Apr 29 2019 
[| Active (1) 
[| Completed (0) 
[_] Failed (0) 
[| Suspended (0) 
[_] Terminated (0) 


+ Severity type 
Person 


Name or user name 


Last modified date 
From Date lime od 
To Date Tirne e 


Refresh 
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Part 4: Apply asset tags 


The Process Designer library now has a number of assets for the Hiring Request Process 
process. You can use asset tagging to organize your existing process application assets. Asset 
tagging allows developers to accomplish tasks such as associating a UCA with its enabling service. 


__1. Tag the Systematic Request Start service. 


a. Click DESIGNER to return to the Designer mode of the Process Designer. 


DESIGNER INSPECTOR 


~t Systematic Request ~ ® @ ka 


b. Inthe Designer library, open the Services category. 


c. Right-click the Systematic Request ES service. 


d. Click Tags > New. 


[Type v] Services 


HR Recruitment Proc 


Processes Deployment Service Flow 
¥ Deployment Service Flow 


User Interface Service Flow 


# Salary Compliance Service 


Services 
istematic RequestES 
v : ~ Open 
Events Favorite 
Tags r Data 
Teams Revert... Database 
Copy to tip Integration | 
: ; : 
Data Copy 5 to Mail 
Move item to » Optimizer 
Duplicate . 
Performance _ Public 
— Quick Start 
xX Delete 
Files SLAs +— 
Stock 
Toolkits Stock (deprecated) 
Users | 
Smart Folders Work Schedule 
XML 


Favorites a 
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__e. Name the tag UCA and then click FINISH. 


New Tag or Tag Group 


Create a new tag or a new tag group. 


Tag name: UCA 
Create a new tag group: 


f. Return to the library and open the Events category. 
__g. Right-click the Systematic Request UCA. 
__h. Click Tags > UCA. 


Open 


Favorite 
Tags » Data | 
Revert... Database 
Copy to tip Integration | 
Copy item to r Mail 
Move item to » Optimizer 
Duplicate Public } 
Rename Quick Start 
xX Delete SLAs 
Stock 
Stock (deprecated) | 


Users 
Work Schedule 
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__i. Click the HR Recruitment Processes header at the top. This category lists all the 
artifacts in the library. The two artifacts are now tagged with UCA in parenthesis after the 
artifact name. 


Al 


9° 
i 


Process 
() Approve Hire Request 
s) Hiring Request Process 
Deployment Service Flow 
¥# Deployment Service Flow 
Service Flow 


@” Salary Compliance Service 
#” Systematic Request ES (UCA) 


a 
w 
= 


44 General Managers 


Undercover Agent 
“we Systematic Request (UCA) 
Theme 


© Hiring Request Theme 


__ 2. Group artifacts by tag. 


a. From the HR Recruitment Processes menu, you can view all the assets in the library. 
At the top of the list, the default grouping is by Type. Click the arrow to the right of Type. 
Select Tag from the list. 


b. The artifacts with the tag UCA are now grouped in the list. 


Approve Hire Request 
v Deployment Service Flow 
4& General Managers 


Hiring Request Process 
® Hiring Request Theme 


#” Salary Compliance Service 


‘wa Systematic Request (UCA) 
#” Systematic Request ES (UCA) 
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__c. After viewing the Name grouping type, return the grouping type back to Type. 
___3. Create a favorite. 
a. Click the Processes category. 


b. Hover to the left of the Hiring Request Process. The outline of a star appears next to 
the process name. 


c. Click the star next to the Hiring Request Process to designate it a favorite. 


Processes 


HR Recruitment Process 


Processes Process 


) Een Hire Request 


__d._ Ifit is not already expanded, open Smart Folders at the bottom of the library. Click 
Favorites to verify that the process is now part of the Favorites smart folder. 


+") Optional 


You have completed part 3 of 5, so you are now half done with this exercise. Now would be a good 
time to take a 10-minute break. 
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Part 5: Create a service to query a database and populate a list 


In this part of the exercise, you create a service to query a database and populate a list. The current 
systems require employees to look up different codes and enter them into the system. Because 
customers use this system, a better approach is to offer a menu with readable options that 
correspond to the codes in the database. The Job Level and Department Details values make up 
the menus. 


The tables are already established in the TRAINING database as JOBLEVELS. You build a new 
business object that is called DepartmentDetails that contains the parameters: Division and 
Department. These parameters match the DIVISIONS and DEPARTMENTS tables in the 
TRAINING database. 


Use an environment variable (ENV) to hold database information for one query, and an exposed 
process variable (EPV) to hold the database information for the other. 


__1. Create a service to retrieve the incident categories. 


__a._ Inthe Process Designer library, click the (+) plus sign next to Services and select 
Service Flow. 


__b. Name the service Retrieve Department Categories and click FINISH. 


__ 2. Add variables to the service. These variables hold the list data that is retrieved from the 
database. 


__a. Click the Variables tab. 
__b. Add an output variable named: departmentCategoriesList 


__c. Select the Is List check box and then click Select for the variable type. 


Name: departmentCategoriesList 
Documentation: BIU | = === i= = | 
DE = 


Is list: 
Variable type: P String System Dat New... 
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__d. Select the Show all business objects check box at the bottom, and select 


Select Library Item 


Business Object 1] 
@ NamevaluePair System Data 


a 


This variable is used to populate the list of options in a select menu on the coach. 


__e. Now add a Private variable: sql (String) 


~*» Input 
+ @ Output 
> & departmentCategoriesList (NameValuePair) (List) 


vy @ Private 


@ sql (String) 


& txposed rrocess vanaves 
© Localization Resources 


OO © OO 


__ 3. Add the elements onto the canvas. 
__a. Click the Diagram tab of the service. 


__b. Drag a Server Script from the service palette to the canvas. 
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__c. Rename the server script to: Set SQL 


© 
(Ws) 


Start Set SQL 


Exercise 8. Playback 2: Integrations 


d. Expand the Toolkits > System Data toolkit category in the Process Designer library. 


e. Select the Services category. Drag the SQL Execute Statement service onto the 


canvas to the right of the Set SQL server scriptlet. 
W SLASend Alert Email (SLAs) 


System Data (8.6.0.0) vx” SOL Blob to File (Database) > 


All 


Processes 


User Interface 


Services 


Events 


#” SQL Blob to File (SQLStatement) (Database) 
ra SQL Call Multiple Stored Procedures (Datab... 
Y SQL Call Multiple Stored Procedures (SQLRe... 
# SQL Call Stored Procedure (Database) 

# SQL Call Stored Procedure (SQLResult) (Dat... 
# SQL Call Stored Procedure (SQLStatement) (... 
#” SQL Clob to File (Database) 

#” SQL Clob to File (SQLStatement) (Database) 
# SQL Execute Multiple Statements (Database) 
#” SQL Execute Multiple Statements (SQLResult.... 
#” SQL Execute Script (SQLResult) (Database) 


Teams 
#” SQL Execute Statement (Database) 


Data 


Performance 


Files 


#” SQL Execute Statement (SQLResult) (Datab... 
#” SQL File to Blob (Database) 

a SQL File to Blob (SQLStatement) (Database) 
#” SQL File to Clob (Database) 

# SQL File to Clob (SQLStatement) (Database) 
#” SQL Get Database Type (Database) 


You can find the service that is grouped in with the services that are the Service Flow type, or 
change to sort by tag and view those items that contain the Database tag. You can also type SQL 


Execute to filter the list to find the service. 


If you have problems with dragging the service from the library to the canvas, you can drag a 
Service Task activity from the palette to the canvas. Then, implement the service by using the SQL 


Execute Statement service from the System Data toolkit. 
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__f. Connect the objects on the canvas from left to right. Connect the Start event to the Set 
SQL server scriptlet. Then, connect the SQL Execute Statement. Finally, connect the 
End event. 


Overview Diagram Variables Decisions 


__ 4. Implement the Set SQL server scriptlet. 
__a. Click the Set SQL server script. 
__b. Click the Script properties menu. 


__c. You use a server scriptlet when assigning a value to a single variable. Change the 
service from Script to Scriptlet. 


__d. Click Select next to Binding: and click the sql (String) variable. 


General 


onan 


Script © Scriptiet 
Script 


Binding: @ twiocal.sql (String) 
Pre & Post : 
1 
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e. Enter the following SQL query in the script field. The intent is to map the results directly 
into a NameValuePair object, so you must rename the results to enable that direct 
mapping. Optionally, you can copy the script from the Script2.txt file that is located 
in the C:\labfiles\Support files\Exé8 folder 


SELECT DEPARTMENTCODE as name, DEPARTMENTNAME as value 
FROM TWKS.DEPARTMENTS 


Script ‘ Scriptlet 


Binding: @ twiocal.sq! (String) 


1 SELECT DEPARTMENTCODE as name, DEPARTMENTNAME as value 
2 FROM TWKS.DEPARTMENTS 


__ 5. Map the inputs and outputs of the SQL Execute Statement service. 
__a. Click the SQL Execute Statement service step. 
__b. Click the Data Mapping properties menu option. 


__c. Inthe Input Mapping section, map the tw. local.sql variable to the sql (String) 
variable. 


== Se — 


Properties Validation Errors 


General 
Implementation Vv Input Mapping 
Data Mapping & &D sal (String) 
Pre & Post & D> parameters (List o... 
& D> maxRows (Integer) 
& D> retumType (String) 
& D> dataSourceName ... 


S 


__d. Forthe returnType (String) variable mapping, type (include the quotation marks): 
"NameValuePair" 
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A JDBC data source was already created for you. In the dataSourceName field, type 
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"jdbc/TrainingDB" (include the quotation marks). 
General 
implementation Vv Input Mapping SI 
Data Mapping twlocal.sql & D> sal (String) 
Pre & Post & & &> parameters (List o... 
& & > marRows (Integer) 
“NameValuePair" & D> returnType (String) 
“jdbc/TrainingDB" . &} dataSourceName ... 


In the Output Mapping, map the results (ANY) variable to the 
tw. local.departmentCategoriesList variable. 


Y Output Mapping = 


results (ANY) -~ twlocal.departmentCategoriesList | & 


Save your work. 
Click the debug icon to debug the service. 


Make sure that you are on the Diagram tab so you see the token move between the 
steps in the service. Expand the Data section on the right and click Step over. If 
needed, you might need to click the Search icon from the top to close the search 


window. 


The first step assigns the string to the sql variable for the database call. 


For the SQL Execute step, click Step Over until the status changes to Finished. 


) Retrieve Department 
Categories 


Vv Details 


Instance ID: 57 
Process App: HR Recruitment Processes 
Status: Running 


VY Locations 
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@ Important 


Two commands in the debugger are for stepping through a nested service: Step Over and Step 
Into. When a step in your service is a nested service that contains more than one step, you can use 
Step Into to debug the steps inside the nested service. If you click Step Over, the debugger runs all 
of the steps and moves the token to the end of the nested service, showing only the output after the 
service is complete. 


k. The departmentCategoriesList variable is populated with the values in the database. 
Notice that the departmentCategoriesList variable contains items 0 - 4 as part of the list. 
This result means that the database returned five rows, which were mapped to the 
NameValuePair object per the configuration options of the SQL Execute service. 


No actions were found. 


Instance ID: 57 
Process App: Hiring Requisition Toolkit 
Status: Finished 


Vv Locations 


No locations were found. 


~ (® departmentCategoriesList(NameValuePair)(list) 
— item[0] 
name(String) 101 
value(String) Marketing 


item[1] 


item[2] 
item{3] 
item[4] 


@ sql(String) SELECT DEPARTMENTCODE as nan 
FROM TWKS.DEPARTMENTS 
< > 


__|. Click DESIGNER to return to the Designer view. 
__ 6. Add an exposed process variable (EPV) to manage the data source name. 
The data source name should normally be stored as an environment variable. EPVs are 
designed to store business data because they can be exposed to business users so they 
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can set real-time process variables. In the next two steps, you practice the creation and use 
of both environment variables and EPVs. 


__a._ Click the (+) plus sign in the Data menu option in the Process Designer library. 


__b. Select Exposed Process Value. 


Teams | 


Data 


® Business Object 


Exposed Process Value 


4— User Attribute Definition 


Performance 


Files 


__c. Name your EPV DataSource and click FINISH. 


__d. Inthe Exposed Process Value settings, click the (+) plus sign in the Exposed Process 
Value Variables section. 


v Exposed Process Value Variables 


x 
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e. Set the following values in the Variable Details section: 
- External Name: TrainingDatabase 
- Variable Name: trainingDB 


- External Description: This is the name of the JDBC data source for the 
training database. 


- Default Value: jdbc/TrainingDB 


Vv Variable Details 


External name: TrainingDatabase 

Variable name: trainingDB 

External description: BIU | SHS =Sez= 
RE Ele <e 


This is the name of the JDBC data 
source for the training database. 


Variable type: by String System Data 


Default value: jdbc/TrainingDB 


Use new values: LC 


Because the variable type is String, you do not need to enclose the value in quotation 
marks. 


__f. Save your work. 
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__7. Atthe upper left of the designer, open the History menu and return to the Retrieve 
Department Categories service. 


2 DataSource ®© @ kl 
[> Process App Settings 

(of) Hiring Request Process 

“wa Systematic Request 


I (@) Approve Hire Request 
# Salary Compliance Service 
“ Systematic Reauest ES 


x 
| w” Retrieve Department Categories ® | 
& DataSource 


x 


___a. Open the Variables tab. 


__b. Click the (+) plus sign next to the Exposed Process Variables category in the Variables 
list, and then select the DataSource EPV. 


Vv Variables 
~® Input 


T 
vy & Output 


>» ™® departmentCategoriesList (NameValuePair) (List) x 


vy © Private 


® 
® 
i) 


L 
@ sql (String) 


a® Exposed Process Variables 
(@ Localization Resources 


Ww 


__c. Verify that you added DataSource to the Exposed Process Variables variables list. 


Vv Variables 
~® Input 


T 
vy & Output 


OFS) 


> & departmentCategoriesList (NameValuePair) | * 
y © Private 


Jt 
@ sql (String) 


D © 


2 DataSource 


(& Locaization Resources 


€ 
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d. Click the Diagram tab to return to the service objects. Click the SQL Execute 
Statement step. 


e. Click the Properties > Data Mapping menu option. 


f. Map the trainingDB EPV to the dataSourceName variable. Enter as the 
dataSourceName: String(tw.epv.DataSource. trainingDB) 


You must cast your EPV to a String. Replace the string that you previously mapped to 
the variable with String(tw.epv.DataSource. trainingDB). Although you created the 
EPV as a String type, the system defines it as an EPV type when you map the variable. 
Therefore, you must cast the variable to String to use it. 


v Input Mapping S 


| 
twlocal.sql & &> sal (String) 

& & D parameters (List 0... 

& & D> maxRows (Integer) 
"NameValuePair &> returnType (String) 

& String(tw.epv.DataSource trainingD & > dataSourceName ... 


The warning indicator stays because it cannot validate the complex expression. This is 
normal. 


___g. Save your work. 


__ 8. Create a Service Flow to retrieve job levels; however, use an environment variable (ENV) 
to accomplish this implementation. 


a. Inthe Designer library, click the Services category. Right-click the Retrieve 
Department Categories service flow and click Duplicate. 


¥ Deployment Service Flow 


User Interface Service Flow 


Execute 
— #” Retrieve Department Categories | 
ervices 
#” Salary Compliance Service sila | 
Favorite 
# Systematic Request ES (UCA) 
Events Tags » 
Revert... 


Teams Copy to tip 
Copy item to r 


Data Move item to > 
Duplicate 
Performance Rename 
xX Delete 
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__b. Right-click the new service and click Rename. Name the new service Retrieve Job 
Levels. Click FINISH. 


Service Flow 


w 3 Retrieve Department Categories 


#” Retrieve Department Categories 2 8 


Open 
# Salary Compliance Service ‘ 
#” Systematic Request ES (UCA) 


Favorite 

Tags » 
Revert... 

Copy to tip 

Copy item to » 
Move item to » 


Dunlicate 


| Rename 


xX Delete 


ee 


__ 9. Change the new service to retrieve job levels. 


__a. Return to the new Services > Retrieve Job Levels service flow. Because many of 
these database calls are similar, you just need to change a few things to retrieve the job 
levels from the database. 


b. Click the Variables tab. 


__c. Click the departmentCategoriesList Output variable. Change the variable name to: 
jobLevels. 


__d. Ensure that the Is List check box is selected, and the Variable Type is NameValuePair. 


e. Verify the private variable sql (String) is still present in the variables list. 


~® Input 
vy & Output 
>» w& jobLevels (NameValuePair) (List) 
vy @ Private 
@ sql (String) 
vy 2 Exposed Process Variables 
2 DataSource 
Localization Resources 


O® © © O© 
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__ 10. Add an environment variable to your process application. 


___a. Open the History menu and select Process App Settings. 


# Retrieve Job Levels& v 
! pr Process App Settings 

le) Hiring Request Process (x) 
“wa Systematic Request ® 
(@] Approve Hire Request ® 
a Salary Compliance Service ® 
# Systematic Request ES ® 
# Retrieve Department Categories ® 


2 DataSource ® 


tim e--e. = -_ 


__b. Click the Environment Variables tab and then click the (+) plus sign on the right side of 


the Environment Variables section. 


Overview Environment Variables Servers 


v Environment Variables Gi) 


Key Default Development Test Stage 


___c. Complete the following values for the environment variable: 


- Key: TrainingDB 
- Default: jdbc/TrainingDB 


Overview Environment Variables Servers 
v Environment Variables 
Key Default Development Test 5 
aa ed ae SSO waa ee 1 
TrainingDB ‘ jdbeTrainingDB | 


__d. Save your work. 

__ 11. Implement the Set SQL server scriptlet. 
___a. Return to the Retrieve Job Levels Service Flow. 
__b. Click the Diagram tab. 
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c. Click the Set SQL server script. 
d. Click the Script properties menu option. 


e. Verify that the Scriptlet type is selected and the scriptlet is bound to the tw.local.sq| 
(String) variable. 


f. Change the Implementation script field to: 


SELECT JOBLEVELCODE as name, JOBLEVELNAME as value 
FROM TWKS.JOBLEVELS 


Script © Scriptiet 
Binding: @ twiocal.sql (String) 


1 SELECT JOBLEVELCODE as name, JOBLEVELNAME as value 
2 FROM TWKS.JOBLEVELS 


Alternatively, you can copy the script from the Script3.txt file that is located in the 
C:\labfiles\Support files\Ex8 folder. 


__g. Save your work. 
__ 12. Map the inputs and outputs of the SQL Execute Statement service. 
a. Click SQL Execute Statement on the canvas. 
b. Click the Data Mapping properties menu option. 


c. Under the Input Mapping section, verify that the sql (String) input is mapped to the 
tw.local.sql variable. 


d. Verify the returnType (String) inputis "NameValuePair" (include the quotation 
marks). 


e. Forthe dataSourceName (String) input, enter: tw.env.TrainingDB 


General 
Implementation Vv Input Mapping | 
Pre & Post & & D parameters (Li... 
& & D> maxRows (Inte... 
“NameValuePair" & > returnType (Stri.... 
tw.env.TrainingDB & = dataSourceNa... 
© Copyright IBM Corp. 2019 8-49 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 8. Playback 2: Integrations 


__f. Change the Output Mapping section to the tw.local.jobLevels variable. 


Y Output Mapping Sai<>| 


results (ANY) > | twlocaljobLevels 


__g. Now you can remove the DataSource Exposed Process Variable from the Variables tab 
that was added to the original service and duplicated for this service. 


Y Variables 


~® Input 
vy & Output 
>» & jobLevels (NameValuePair) (List) 
vy @ Private 
@ sql (String) 
y 2 Exposed Process Variables 


2 DataSource 


{= Localization Resources 


. 
V 


© © ®O® O® 


__h. Save your work. 


___ 13. Debug the service to determine whether the data is retrieved from the database correctly. 


__a. Click the debug icon above the palette. 
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__b. Click the Step over icon to step through the service and verify that the database call 
executes and returns data from the database. 


Y) Retrieve Job Levels 


No actions were found. 


Vv Details 

Instance ID: 58 

Process App: Hiring Requisition Toolkit 
Status: Finished 


Vv Locations 


No locations were found. 


~| @® jobLevels(NameValuePair)(list) 

—  item[0] 
name(String) 5001 
value(String) Jr Associate 

+ item[1] 

+ item[2] 

+ item[3] 

+ item[4] 

+ item[5] 

+ item[6] 


@ sql(String) SELECT JOBLEVELCODE as name, JOBLE\ 
FROM TWKS.JOBLEVELS 
< > 


__c. Click DESIGNER to return to the Designer view. 


___ 14. To make these services available to other process applications, move the services to the 
toolkit. 


__a. At the top of the library, click HR Recruitment Processes to view all the assets in your 
library. 


__b. On the top of the asset list, click the icon to change to multi-selection mode. 
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__c. Radio buttons appear to the left of every asset in the library. Select both the Retrieve 
Department Categories and Retrieve Job Levels Service Flow services. Right-click 


and click Move items to > Other Toolkit. 


Service Flow 4) 


#” Retrieve Department Categories sql (String) suis A. > 
#” Retrieve Job Levels - 
= = Open 
#” Salary Compliance Service cali 
#” Systematic Request ES (UCA) — 
Revert... 
4& General Managers Copy to tip 
Canv items t¢ > 
Undercover Agent ——— 
comand =e 
Systematic Request (UCA) Duplicate Other Toolkit. 
Theme Rename 


__d. Click Hiring Requisition Toolkit. 
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The system identifies the dependencies. Click MOVE. 


Move Artifacts to Toolkit: Hiring Requisition Toolkit 


Select artifacts to move: 

Selected artifacts will be moved. 

# Retrieve Department Categories 
# Retrieve Job Levels 


Select dependent artifacts to move: 
Broken references might occur if you do not move dependent artifacts. 


2 DataSource 


Artifacts with dependencies on selected artifacts: 
Selected items will be moved. Items that are not moved might cause broken references. 


[wove _}|[ cance 


@ Troubleshooting 


If a permission error message is displayed during the move then log out of the Workflow Center and 
then log back in as author1 and do the move again. 
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___ 15. In the last exercise, you created a Hiring Request Theme. To make this theme available to 
other process applications, move the theme to the Hiring Requisition Toolkit. 


__a. Open the User Interface category in the library. Turn the multi-select off for this next 
move. 

User Interface 
@ Hiring Request Theme 

__b._ Right-click User Interface > Hiring Request Theme in the library. Click Move item to > 
Other Toolkit, and select the Hiring Requisition Toolkit. 

__c._ Inthe Move Artifacts to Toolkit window, click MOVE. 

__d. Finally, because the ENV variables are specific to the toolkit or Process App, you need 
to re-create the environment variable for this toolkit. Click the View in Workflow Center 
link. 

© 

__@. Click the Toolkits tab. 

__f. Click Open in Designer for the Hiring Requisition Toolkit. 

__g. At the top, click the Environment Variables tab. 

__h.. Inthe Environment Variables section, add the TrainingDB key with the default value of 
jdbc/TrainingDB. This setting is needed to run the Retrieve Job Levels service. Click 
the (+) Add icon from the right to add a variable. 

Overview Environment Variables Servers 
v Environment Variables 
Key Default Development Test E 
TrainingDB —_! jdbe/TrainingDeB ! 
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Part 6: Change an input to a single select on a coach 


Until now, any value would be accepted for the Department input on the page. If only certain values 
are allowed, you must then approach the control in one of the following ways. The first way is to 

limit the input to only acceptable values by using a selection like the single select on a coach. The 
second way is through validation of the input data. Many times the solution is a combination of both 
of these approaches. This section demonstrates how to create a single selection to limit the values 


that are allowed. 
__ 1. Apply the Hiring Request Theme to the Hiring Requisition Toolkit. 


__a._ Inthe Overview > Coach Designer Settings section, click Select and select the Hiring 
Request Theme. 


Y Coach Designer Settings 
Heritage Coach XSL: fal CoachDesignerxs! System Data 
Heritage CoachCSS: fl coach _designercss System Data 


__b. Save your changes. 
___2. Add the Retrieve Department Categories service to the Hiring Form human service. 
__a. Select User Interface from the library and click Hiring Form. 


__b. The Hiring Form service opens. In the Diagram tab, drag a Service from the palette 
onto the Hiring Form canvas between the Start event and the Hiring Form coach. 


__c. Reconnect the Hiring Form flow so that the new service is part of the flow. 


a “or z Map N 
; re 
: q 4 ___ 5 Subynit 
= >  Serice ® Hiring Form — * Position Var 
| star —" 


__d. Rename the new service step to: Retrieve Department Categories 
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__e. Select the Retrieve Department Categories service. In the Implementation properties 
menu, click Select for the Call a service setting. 


Properties Validation Errors 


General 
Implementation v Behavior 
Data Mapping © Call a service 


Pre & Post <none> New. ] 


Work with the process instance variables 


__f. Select the Retrieve Department Categories service that you created. 


Select Library Item 


Service Flow 


#” Retrieve Job Levels 
#” Retrieve Task Details BPM UI 
#” Team Retrieval Service Template System Data 


__g. Save your work. 
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___ 3. Map the output variable of the service and allow the system to create the private variable. 


a. Inthe Data Mapping > Output Mapping properties section, note that the service 
requires you to map a variable to the departmentCategoriesList variable. 


General 


Vv Output Mapping 


Implementation 


Data M i 
ce 8a departmentCategoriesList (List 0... <> 
Pre & Post 


b. Click the Variables tab. Create a private variable: departmentCategoriesList 
(NameValuePair) (List) 


Overview Diagram Coaches 
Ria | 


vy @ Input @ t 
> ® requisitionDetails (HiringRequisition) 
y © Output @| * 
>» © requisitionDetails (HiringRequisition) L 
@ isNewPosition (String) 
vy @ Private G) 


» © departmentCategoriesList (NameValuePair) (List) 


& Exposed Process Variables i) 
= Environment Variables @ 
Localization Resources @ 


ia) Reminder 


Select Show all business objects to choose the NameValuePair variable type. 


@® SPMAlertDefinitionStatusResponse System ... 
+ 3 BPMBOPropertyChange System Data 
@ BPMBOSaveFailedError System Data 
@ BPmMBOSaveSeniceValidationErrors System ... 


a. 


ad ae ¥ 


Show all business objects 
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c. Return to the Diagram tab. Verify that the Retrieve Department Categories step on 
the canvas is selected. In the Data Mapping properties section, map the 
departmentCategoriesList variable to the output 
tw. local.departmentCategoriesList. 


Y Output Mapping S >I 
departmentCategorie “ — twlocal.departmentCategoriesList & 


__d. Save your work. 
__ 4. Change the control on the Hiring Form coach to a single select. 


a. Click the Coaches tab and the Hiring Form coach. Initially when you view the coach, 
the server must generate the CSS and render the new coach on the screen, so a delay 
might occur before you see the effect. 


b. From the Department Details tab, select the control Department that is bound to the 
department variable. 


Requisition Details Position Details Recruiting Details 


Compensation Details Department Details 


Department 


Division 


ec) 


Change the view that the control is bound to. Right now, all the input boxes on the coach are text 
views. These controls are all variables that are bound to String data types. 
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c. Inthe General > Behavior properties section, click Select next to View. 


Binding: @ requisitionDetails.departmentDetails.department (String) 
View: [ltext (String) UI Toolki New... 
bol 


Label visibility: @ show 


__d. Select the option Single Select (UI Toolkit) coach view. 
After you change the view binding, the control on the palette has a different look. It is 


- oe 
now a Single Select view control. 


Requisition Details Position Details Recruiting Details 


Compensation Details Department Details => 


DIVISION 


pT 


__f. Save your work. 
__5. The select control returns the single element that is chosen from the list, and you must 
create a simple list variable to store the selection. 


__a. Click the Variables tab of the Hiring Form service. 
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__b. Create a private variable: department (NameValuePair ) 


7] 


— Input + | 
+  requisitionDetails (HiringRequisition) 
— @ Output i 
+ @ requisitionDetails (HiringRequisitian) 
@ isNewPosition (String) 
- @ Private + 
+ @ denartmentCatecoriesList (NameValuePair (List) 
2 Exposed Process Variables 
= Environment Variables 
Localization Resources 


+ be 


__c. Save your work. 
__6. Store the selected department to the department variable. 
a. Return to the Coach. 
b. Select the Department control under the Department Details tab. 
c. Inthe General > Behavior properties section, click Select next to the Binding property. 
__d. Click the new Private variable department (NameValuePair) from the variable list. 


__7. Configure the setting that determines the list of selections available to the user on the 
Department select control. 


__a. Click the Configuration properties menu. Expand the Items section. 
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__b. Change the Item lookup mode to Items from Config Option. Click Select next to the 
Item input data setting and click the departmentCategoriesList (NameValuePair) 


variable. 
General 
Positioning * Belin 
Configuration 
Events Y Items 
a Item lookup mode: @ | items From Config Option v 


HTML Attributes Item input data: @ departmentCategoriesList] (NameValuePair)[ Select... | 


> Item selection data: © 


> Output business data: © 


> Appearance 


rd) Note 


Because the control uses the .name variable for the Display Name Property and the .value of 
the Value property settings by default, you do not have to set those settings. If you are using a 
variable other than a NameValuePair, you must assign the values that populate the name and 
value of the control. 


__c. Save your work. 


__ 8. The Department selection that is stored in the private department (NameValuePair ) 
variable must be mapped to the parameter of the business object. Bind the selection value 
back to the business object parameter. 


__a._ Inthe Hiring Form service, click the Diagram tab. 


__b. Change the name of the Map New Position Var script to: Map Vars 
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__c._ Inthe Script properties menu, add the following code to the bottom of the script: 


tw. local. requisitionDetails.departmentDetails.department = 
tw. local.department .name; 


This editor uses standard JavaScript syntax. Press Ctrl-space while typing to receive assistance with the script 
syntax and contents 


1// This JavaScript will run within the browser and must use the client-side JavaScri 
- To instanti 


2// - To instantiate a complex object: 

3// tw.local.customer = {}; 

4// tw.local.customer.name = “Jane"; tw.locé 
Sif (tw.local.requisitionDetails.recruitingDetails.newPosition == true) 
6tw.local.isNewPosition = “1"; 

7 else 

Rtw.local.isNewPasitioan = "A": 


tw.local.requisitionDetails 


__d. Save your work. 
__ 9. Debug the coach, and verify that the Department single select works and binds the data to 
the variable. 


__a. Click the Debug icon. 


__b. When the debug window opens, minimize the new window. 


__c. Click Step over. 


EMI °o 


(n) Hiring Form 


Instance ID: 1 
Process App: Hiring Requisition Toolkit 
Status: Paused 


VY Locations 


© Retrieve Department Categories 
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__d. The departmentCategoriesList variable is populated with data from the integration 
that you created in the last exercise. 


Vv Locations 


© Hiring Form 


Ss requisitionDetails(HiringRequisition) 


“® isNewPosition(String) <Empty> 


~ @ departmentCategoriesList(NameValt 
— item[0} 
name(String) 101 
value(String) Marketing 


+) item[1] 

+| item[2] 

+ item[3] 

+) item[4] 

@ department(NameValuePair) <Empt 
< > 


__e. Click Step over to show the coach. The coach is displayed in the Playback window. 


__f. Click the Department Details tab. The database retrieval service now drives the 
selections that are presented to the user. 


Requisition Details Position Details Recruiting Details Compensation Details =| 


Department Details 


Department 


Marketing 


Finance 

Engineering 
Professional Services 
HR 
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__g. Inthe Department field, select HR and click Submit. 


Requisition Details Position Details Recruiting 


Department Details 


Department 


ic 


Division 


__h._ Verify that the data is bound to the variable inside the debugger. 


S ‘reauisitionDetails(HiringRequisition) 
“® isNewPosition(String) <Empty> 
— @ departmentCategoriesList(NameValt 
~ item[0] 
name(String) 104 
value(String) Marketing 
+ item[1] 
+ item[2] 
+ item[3] 
+ item{4] 
- @ department(NameValuePair) 


name(String) 105 
value(String) HR 
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__i. Click Step Over. Verify that the data was mapped into the 
requisitionDetails.departmentDetails.department pipeline variable. The Map 
Vars script stores the key for the object, not the value. 


- = requisitionDetails(HiringRequisition) 


requester(String) <Empty> 
requisitionNumber(String) <Empty> 
— departmentDetails(DepartmentDeta 
division(String) <Empty> 
department(String) 105 
hiringManagerComments(String) <E 


+ compensationDetails(Compensatio 
datePositionAvailable(Date) <Empt 
+ position(Position) 
dateOfRequest(Date) <Empty> 
+ recruitingDetails(RecruitingDetails) 
“® isNewPosition(String) 0 
+| @ departmentCategoriesList(NameValt 


__j. Close the Debug Hiring Form browser window. 


___ 10. Update the process application HR Recruitment Processes dependency to the most recent 


version of the Hiring Requisition Toolkit. 


a. Return to Process Designer and click the View the Workflow Center icon. 


cs) C v) authori Vv 


CREATE NEW (+) 


__b. Click the Toolkits > Hiring Requisition Toolkit (HRT) link. 


__c. On the right, click Create New Snapshot. 


| | + Create New Snapshot 


€ Open in Designer 
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__d. Name the snapshot Playback 2 and provide the following documentation: This 
snapshot includes integrations. Click Create. 


Create New Snapshot 


Snapshot Name 
Playback 2 
Documentation 


Bi 1\U} ton v|[= 


This snapshot includes integrations. 


e. Click the Process Apps tab. Open the HR Recruitment Process process application. 
f. Expand the Toolkits category in the library. 


__g. Click the arrow next to Hiring Requisition Toolkit (Baseline) and click Upgrade 
Dependency to Playback 2. 


a YY Monitor Settings 
BPM UI toolkit 


Enable process monitoring through IBM 


Upgrade Dependency to (Playback 2) | 


Ignore Version (Playback 2) of Dependency 


System Data | 
Change Version of Dependency 


>< Remove Dependency 
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__h. The dependency is now upgraded to Playback 2. 


BPM UI toolkit 


i. Playback 2: Integrations, is now complete. 


__j. Return to the Process Apps tab by clicking the View the Workflow Center icon. 
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Part 7: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__c. Enter Exercise 8 solution for the name. 
__d. Click Create. 


__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
You can only export snapshots. 


__a. Click Export next to the snapshot. 


__b. Inthe Export Process App window, click Export. It might take a minute or two to 
generate the . twx file. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

( IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


c. Click OK to save the file. The application is saved to the default folder, which is the 
Downloads directory. 


d. Verify that the application is listed in the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


#2 HR Recruitment Process (HRR) History Governance 


__b._ Inthe right panel, click Archive Process App. 
————— === 


2 Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated +» All | W Favorites | Archived 


e. Click Delete. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


Sra aoa 


f. In the window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


__g. Click All to switch back to the Process Apps tab. Note that the HR Recruitment Process 
is no longer listed. 


__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 


__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit (HRT) toolkit. 
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__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) History Governance 


__c._ Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 


@ View Archived Tracks 


__d._ Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 
delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


__@. Click Toolkits again and this time click the Archived link. 


Logged in as author’ (author1)| Preferences | Logout 


Sort By: Recently Updated ~ All | w Favorites | Subscriptions | Shared 


__f. Click Delete. 


Logged in as author? (author!) | Preferences | Logout 


Sort By: Recently Updated ~ All | w Favorites | Subscriptions | Shared | Archived 


__g._ Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h._ Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


The first part of this exercise looked at creating a decision service. You created rules in 
Business Action Language (BAL) to support the service and then implemented the new 
service in a process. Next, you created a message start event as a trigger to run the 
process. You organized assets with tags. Finally, you built a query service to read 
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information from a database. The query service is built with environment variables and 
exposed process variables. 


End of exercise 
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Exercise 9. Playback 3: Handling errors 
and deploying your process 
application 


Estimated time 


01:30 


Overview 


This exercise covers how to implement error handling in a service. 


Objectives 


After completing this exercise, you should be able to: 
¢ Harden a service with a catch exception component 


¢ Create a snapshot for deployment 
Introduction 
In this exercise, inside the Process Designer service diagram, you drag a Catch Exception and 


attach it to a generic service or a human service. You then create a flow from the Catch Exception. 
Finally, you create a snapshot for deployment. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 8 process application solution that is required to start 
exercise 9. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


*} Create New Process App 
& Import Process App 


$= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select the HR_Recruitment_Process - 
Exercise_8_ solution.twx. 


d. Click OK. 


e. Inthe Import Process app window, click Import. Make sure that the Open in Process 
Designer option is not selected. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 
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h. Click Hiring Requisition Toolkit and then click Manage. 


i. Click Allow users to update toolkit. This is required for any updates to the toolkit. 


(_] Allow users to update toolkit 


__j. Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise. 


Allow users to update toolkit 
CJ Allow users to create tracks in this toolkit 


Why Tracks 


Part 2: Implement exception handling in a service 
__1. Adda Catch Exception event to the Hiring Form service. 
__a. Click the Toolkits tab. 
__b. Click Open in Designer to open the Hiring Requisition Toolkit (HRT). 
c. Inthe Hiring Requisition Toolkit, open the User Interface > Hiring Form human service. 


d. On the Diagram tab, drag an Intermediate Event from the service palette on to a 
control point on the Retrieve Department Categories service. 


>. c eRe 


Retrieve a ie er ee” ee ee 
; Submit & > 
WY Denartment > HiringForm ~—C3 Sebmi Map Vars ( ) 
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__ 2. Addacoach to display an error message. 


__a. Drag a Coach from the service palette onto the canvas. Rename the coach: Show 
Error Message 


9) 

olan " 

; a z wie 
O—*|copstmons|—* tieaFam eeeney wove -—=@ | 


Start a End v 


mz, 


___3. Adda postpone task service. 


__a. Drag an Intermediate Event from the palette to the right of the Show Error Message 


coach. 
=) 
- , LSJ 
. & & 
, > Department > Hiring Form Sj Submit: p> Map Vars ~O (2) 


Start —— End (ond 


oe Error © 


\eosy) 
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b. With the new Intermediate Event selected on the canvas, open the Implementation 
properties menu. Change the Event Type to Postpone. Leave the Event Navigation as 


Default (behavior provided by the hosting Ul). 
General 
implementation v Event Type 
Pre & Post 
E 
v Event Navigation 
& 


URL 


Open the General > Common properties section and rename the new event: Postpone 


0) 


& 
End 


Retrieve : 
iri Sj Submit 
ae ” Department... > Hiring Form —Gi Submite = Map Vars 
Start 
Show Error © 


__C. 
Task 


Postpone Task 


Pre & Post 
Name: 


Documentation: Rin 


__d. Save your work. 
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__ 4. Create the error message coach. 


__a. 


-.U: 


Click the Coaches tab and select the Show Error Message coach. 


Variables Coach: Show Error Message v 
Hirina Form _- 
Show Error Message 


In the “Select a Template” window, ensure that Start with a default coach is selected, 
and click OK. 


Select a Template 


@) Start with a default coach 
© Start with a grid: [7] Single Column ¥ 


Selecttemplate: v 


__c. Highlight the OK control and place the cursor over the top portion of the highlight to 
bring up the (+) plus sign. 
Overview Diagram Variables Coach: Show Error Message v 
OK 
® 
__d. Click the plus sign on the highlighted line to bring up the Palette interface. 
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__@. Scroll down and select Panel. Alternatively, you can enter Panel in the filter text field 
and then select Panel. The panel is placed on top of OK. 


= oo8 me hh O&O 


enter filter text a a § 
6 

Output Text Panel Footer Panel Header Password 
. awe cn a 
y = 3) ses o}-"fe 

Pie Chart SDS Places Pop-up Menu Progress Bar QR Code 
iF rs Beas 
° le x D> * 


__f. Under the General > Common properties section, label the panel as: An error has 
occurred. 


Overview Diagram Variables Coach: Show Error Message v =) 


An error has occurred 


Add content here 


General 


Configuration Laver © pining 
as 2 ~ 
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__g. Click the section that is labeled Add content here, and add another Panel inside the 
first one. 


Overview Diagram Variables Coach: Show Error Message v CJ GQ) | 


An error has occurred 
Panel 


Add content here 


® 


h. Change the display label on the internal panel to: Error Information 
i. Click the section that is labeled Add content here, and add a Custom HTML control. 


__j. Under the HTML properties menu, select Text and add error information to the HTML 
text block that is provided to the user. Alternatively, you can copy and paste the text that 
is provided in the file Script1.txt at the location: C:\labfiles\Support files\Ex9 


<p>An error has occurred. You can either retry what you were doing, or you 
can postpone this activity until a later date.</p> 

<p>If you need further assistance, please call our customer service 
hotline: (555)555-5555.</p> 


An error has occurred 


Error Information 


<p>Custom HTML</p> 


General 
HTML Vv 4 TV 
HTML | » Text | Managed File | Variable 
Text: Lurred. You can either re-try what you were doing, or you can postpone this ac’ 
2.er assistance, please call our customer service hotline: (555)555-5555. </p> 
< > 
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k. Highlight the OK control and place the cursor over the bottom portion of the highlight to 
bring up the (+) plus sign. 


|. Click the plus sign on the highlighted line to bring up the Palette interface. 


m. Select Button in the Palette interface. The Button is placed below OK. 


OK 


® 


n. Change the OK button label to: Retry. 


__0. Change the second button label to: Postpone. 
__p. Save your work. 

__5. Reconnect the flow on the Hiring Form canvas. 

a. Click the Diagram tab. 


b. Connect the new elements on the canvas. First, connect the Error Intermediate Event 
event to the Show Error Message coach. 


c. Next, connect the Show Error Message coach to the Postpone Task event. 


d. Third, connect Postpone Task back to Show Error Message. 
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__@e. Finally, connect Show Error Message to Retrieve Department Categories by the 
Retry control. 


re) » 
a Retrieve ~O 
bP Submit 
wy Department. > HiingFom Ea soms-> =6Map Vars 
Start a End 
@: 
. 
Wj Postpone 2 
“Sh Error 
ow 
j— J Retry —°@ 
” Postpone Task 
General 
implementation Y Common v Behavior 
Name To Postpone Task End state binding Retry 
Name visible Select 
Documentation BIrUul==z Show end state | 


f. Note that the label on the flow is incorrect. The instructions intentionally wired the flows 
up to the wrong event. In this flow, the Postpone button retries the service while the 
Retry button postpones the task. That would be incorrect. After you connect the Show 
Error Message coach to other activities, the flow editor automatically uses the button 
controls from the coach. If the controls do not match the flow, you can either reroute the 
connection arrows or change the end state binding. To change the end state binding, 
select the Postpone flow. 


Reteve 
) j Suomit Vars 
~~” Department > Hiring Form = «(Me ~O 
Start (A Ena 
7) 
ey a 


r (>) 
SS Revy ——— OG 


a 
"lesan Potone Ts 
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__g. Inthe General > Behavior properties section, click Select next to End state binding. 


v Behavior 


End state binding: | Postpone 


Show end state: 


__h. From the coach dialog box, select the Retry button. 


| Retry 
| Postpone 


__i. Click Yes to confirm the binding change. 


(?) Confirm the binding change 


The selected binding is already in use by another connection. 


Click Yes to swap the binding of the current connection with the binding 


of the connection that you have just selected. Click No to keep the 
binding unchanged. 


__j. Ensure that your buttons on your coach correspond to the correct flows on the coach. 


& S 


% 
o > RnaredNG yaaa Sj Submit -> Map Vars i 2 @) 
Start | End 


ail 
a 


Show Error } sj Postpone - H 


Postpone Task 


Gj Rety 
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__ 6. Save your work. 


Part 3: Prepare for final snapshot 


__ 1. Check for any validation errors in the process application. 


Before taking the final snapshot of the process application for deployment, it is a good practice 
to check for any validation errors in the process application. 


__a. Click the View the Workflow Center icon. 


View the Workflow Center 


b. Open the HR Recruitment Processes process application by clicking Open in 
Designer. 


c. Validation errors must be resolved before you deploy a process application to a different 
environment. The instructions thus far introduced an error in the process application. 
You correct this error before the deployment of your process application. In this 
example, the Hiring Request Process contains an error. To resolve this error, in the 
Process Designer footer, click the Validation errors and warnings icon to check the 
name of the process that contains the error. Note that there is number 1 next to the icon 
indicating one warning or error. 


ai] 


d. Clicking the Validation errors and warnings icon displays the process that contains 
the problem. 


Lee . ; 


¥ @) Process (1 warning) 


» () Hiring Request Process (1 warning) 
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__e. Expand the Hiring Request Process to view the error message. 


Y 6 Process (1 warnina) 


¥ “<) Hiring Request Process (1 warning) 


® No input parameter mapping found for parameter without default: requisitionDetails 


__f. To resolve the parameter mapping errors, click the error message to directly open 
Hiring Request Process and then click the Submit Hiring Request activity. 


Submit Hiring | 
7 Request i oe 


Hiring Manager 


Review Needed Review Not Needed 


4 


cS 
Approve New 
Hire Request 


General Manager 


__g. Open the Data Mapping properties menu. 
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__h._ Inthe Input Mapping section, map the input to the requisitionDetails 
(HiringRequisition) variable by typing tw. local. requisitionDetails. 


Vv Input Mapping | 


tw.local_requisitionDetails & > requisitionDetails (Hiring 


__i. Inthe Output Mapping section, map the first output to the requisitionDetails 
(HiringRequisition) variable by typing tw. local. requisitionDetails. 


__j. In the Output Mapping section, map the second output to the isNewPosition 
(String) variable by typing tw. local.isNewPosition. 


Y Output Mapping 


requisitionDetails (HiringRequisition) tm) tw.local.requisitionDetails 
isNewPosition (String) <> __ twlocal.isNewPosition 


__k. Select the Approve New Hire Request activity. 
__|. Open the Data Mapping properties menu. 


__m. Inthe Input Mapping section, map the input to the requisitionDetails 
(HiringRequisition) variable by typing tw. local. requisitionDetails. 


Vv Input Mapping | 


__n._ Inthe Output Mapping section, map the first output to the requisitionDetails 
(HiringRequisition) variable by typing tw. local. requisitionDetails. 
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__o. Inthe Output Mapping section, map the second output to the isNewPosition 
(String) variable by typing tw. local.isNewPosition. 


Y Output Mapping 


requisitionDetails (HiringRequisition) > tw.local.requisitionDetails 
isNewPosition (String) => tw.local.isNewPosition 


__p. Save your changes. 


__q. Verify that there are no more any errors or warnings. The Validation and errors icon 
indicates a zero next to it. Close the validation panel. 


re, Showing 0 of 0 items 


The current project has 0 validation errors or warnings. 


Part 4: Check the history of the process application 


__1. Before taking a snapshot of the process application for deployment, you can check the 
history of the actions that you performed on the process application. 


__a. Return to the Workflow Center. 


Lt) es v) author1 Vv @ 


__b. Click the HR Recruitment Processes process application. 
__c. Click History. 
__d._ Verify the set of actions that you performed on the process application from the 
beginning. 
Part 5: Create a snapshot of the process application 
__1. Create a snapshot of the Hiring Request Process in IBM Process Designer. 


__a. Click the Process Apps tab. Open the HR Recruitment Process process application in 
Process Designer. 
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__b. Expand the Snapshot menu on the top of the Process Designer window. Select Create 
a new snapshot. 


Create a new snapshot 


| View existing snapshots 


c. Give your snapshot the name Playback 3 and description: This is a snapshot for 
Playback 3. Click FINISH. 


Take Snapshot 


Take a snapshot to capture the current process application. 


Name: |Playback 3 


Description: 
Rf 
This is a snapshot for Playback 3. 


FINISH CANCEL 


d. Click OK when the pop-up window is shown. 

e. Return to Workflow Center. 

f. Click the HR Recruitment Process process application. 
__g. Your snapshot is displayed in the list of snapshots. 

___2. Create a snapshot of the new toolkit and upgrade the dependency to the new snapshot. 
__a. Click the Toolkits > Hiring Requisition Toolkit (HRT) link. 
__b. On the right, click Create New Snapshot. 


_ | + Create New Snapshot 


€ Open in Designer 
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__c. Name the snapshot Playback 3 and provide the following documentation: This 
snapshot includes error handling for a service. Click Create. 


Create New Snapshot 


Snapshot Name: 
Playback 3 


VULUTNICHIIAUUT. 


Bi) 1 |U) 12pt VE =} := |= | 93 | +3) co 


This snapshot includes error handling for a 
service. 


d. Open the Process Apps > HR Recruitment Process process application in Process 
Designer. 


e. Click Toolkits in the library. Click the arrow next to Hiring Requisition Toolkit and click 
Upgrade Dependency to (Playback 3). 


v Co 
Toolkits Implementation 


Data Mapping Name: 


i Upgrade Dependency to (Playback 3) 


Sip USnIGy_DSIDENOSD gu UaEpEPEDINY Tap are ersapronea antl 
Change Version of Dependency 
> Remove Dependency 


__f. Playback 3: Creating error handling for a service is now complete. 


__g. Return to the Process Apps tab by clicking the View the Workflow Center icon. 
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Part 6: Export the process application and do cleanup 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Click the HR Recruitment Process process application. 


__b. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


$ Open in Designer 


__c. Enter Exercise 9 solution for the name. 
__d. Click Create. 

__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
__a. Click Export next to the Exercise 9 solution snapshot. 


__b. Inthe Export Process App window, click Export. 


Export Process App x 


Select an export file type. 
(@) IBM Business Automation Workflow export (.twx) 


() IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


Export 


c. Click OK to save the file. The application is saved to the default folder, which is the 
downloads directory. 


d. Verify that the application is listed to the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Click Manage. 


Process Apps Toolkits Servers 


¢({ HR Recruitment Process (HRR) History Manage Governance 


__b._ Inthe right panel, click Archive Process App. 
—————————————===————== 


2 Archive Process App 


@ View Archived Tracks 


c. Inthe window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


d. Click Process Apps again and then click the Archived link. 


Logged in as author! (author!) | Preferences | Logout 


Sort By Recently Updated » All | W Favorites | Arch 


e. Click Delete. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | W Favorites | Archived 


z A 


f. In the window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


__g. Click All to switch back to the Process Apps tab. Note that the HR Recruitment Process 
is no longer listed. 


__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 


__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit (HRT) toolkit. 
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__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) History Manage Governance 


__c._ Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 


@ View Archived Tracks 


__d._ Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 


delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


__@. Click Toolkits again and this time click the Archived link. 


Logged in as author’ (author1)| Preferences | Logout 


Sort By: Recently Updated »~ All | w Favorites | Subscriptions | Shared | Archived 


__f. Click Delete. 


Logged in as author? (author!) | Preferences | Logout 


Sort By: Recently Updated » All | w Favorites | Subscriptions | Shared | Archived 


& Restore | 3 


__g._ Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h._ Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


In this exercise, you added a Catch Exception component to capture and manage errors in 
the process. You then prepared a snapshot. If any validation errors were present in the 
process application, you resolved any problems. Next, you looked at the history of the 


actions that were performed on the process application and created the snapshot for 
deployment. 
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End of exercise 
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Exercise 10.lmplementing the “four 
eyes” policy by using a team 
filter 


Estimated time 


01:30 


Overview 


In this exercise, you learn how to implement a “four eyes” policy in a process by using a team filter. 


Objectives 
After completing this exercise, you should be able to: 
¢ Implement the “four eyes” policy by using a team filter 
Introduction 


The company chief executive officer (CEO) is concerned about the activity in the HR Administrator 
lane during the approval linked process. The CEO wants to make sure that if an override is 
required, two people must look at the request, enabling a “four eyes” policy for activities in that 
lane. You must create a second activity in the lane, and use a routing policy to ensure that the user 
who completed the first activity in a lane does not claim the second activity in the lane. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 9 process application solution that is required to start 
exercise 10. This import ensures that you have a good copy of the process application at the start 
of an exercise. Importing this exercise is optional if you completed the previous exercise 
successfully and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


*} Create New Process App 
& Import Process App 


$= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select the HR_Recruitment_Process - 
Exercise 9 solution.twx. 


d. Click OK. 


__e. Inthe Import Process app window, click Import. Make sure that the Open in Process 
Designer option is not selected. 


__f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 
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2. Imported toolkits are immutable, which means that no one can change the items within an 
imported toolkit. Administrators can change the immutable quality of a toolkit by enabling 
the Allow users to update toolkit option in the Manage tab for the imported toolkit. You 
must do this step otherwise you cannot make any changes or updates to the toolkit in the 
exercises. Do not skip this step. 


a. Click Hiring Requisition Toolkit and then click Manage. 


__b. Click Allow users to update toolkit. This is required for any updates to the toolkit. 


L_] Allow users to update toolkit 


__c._ Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise. 


Allow users to update toolkit 
a Allow users to create tracks in this toolkit 


Why Tracks 


Part 2: Modify the process 


The first steps of this exercise are to change the process to meet the new requirements of the 
organization. After the process is changed, you will then implement the four eyes policy using Team 
Filter services. 


1. Create the verify activity to make sure that if an override is required, two people must look at 
the request, enabling a “four eyes” policy for activities in that lane. 


a. Click the Process Apps tab. 


b. Click the Open in Designer link next to the HR Recruitment Process (HRR) process 
application. 


Open the Processes > Approve Hire Request process in the Designer. 


b. Drag an activity to the right of the Override Hire Request activity. Name this activity: 
Verify Override Hire Request 
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__c. Click Implementation and change Activity Type to User Task. 


General 


v 
Implementation Activity Type 
Assignments 
Pre & Post Y Implementation 


Trackin 
3 Implementation none Select New 


d. Connect Override Hire Request to Verify Override Hire Request. 


e. Connect Verify Override Hire Request to Is Salary Acceptable. 


Not Accepted : 

¥ 
z res le a 
B Override Hire » VerifyOverride | 
= «x» Request Hire Request 
3 pos 
3 = Is Salary 
« bir tues ’ Acceptable 
= 

os Accepted 


__ 2. Create a service to capture the user name during the Override Hire Request step. 


__a. Expand the Toolkits category in the library, and then expand UI Toolkits and select 
User Interface. 


Toolkits ‘) 


Hiring Requisition Toolkit (... 


System Data (8.6.0.0) 


UI Toolkit (8.6.0.0) 


All 


Processes 


User Interface 


Services 


© Copyright IBM Corp. 2019 10-4 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 10. Implementing the “four eyes” policy by using a team filter 


__b. Under the Client-Side Human Service category, right-click the Default UI Human 
Service. 


User interface 


Client-Side Human Service 


Processes 


& Client-Side Human Service 


yx & Default Ul Human Service 


User Interface 


fe) Alerts (Advanced; Informational) 


Services 


c. Click Copy item to > Other Process App. 


Client-Side Human Service 25S 


& Client-Side Human Service 
@ Default Ul Human Service Open 


fa) Alerts (Advanced; informatior 
[ia) Area Chart SDS (Basic; Char os 
(a) Badge (Advanced; Informatio Copy item to 1] [Other Process App.. 


(ia) Bar Chart SDS (Basic; Chart) : umner IOO%KIt... 


Revert... 


d. Select HR Recruitment Process. 
e. Click the Toolkits menu to collapse the category in the library. 


f. Scroll up in the library and this time click the User Interface menu in the library for HR 
Recruitment Process process application. Rename the Default UI Human Service to: 
Override Hire Request 


Open the Override Hire Request human service. 


h. Click the Variables tab and add an output variable userName1 (String) to the 
Override Hire Request service to capture the user name. 


Vv Variables ‘Type to filter 
~® Input ‘C) r 
vy & Output ‘S) 
@ userName‘ (String) . 
vy @ Private @ d 


@ taskid (String) 
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__i. Click the Diagram tab and add a client-side script that is named Capture Username to 
the canvas after the Display Task Details coach. 


=) 


__j. Connect Display Task Details to Capture Username and Capture Username to the 
End event in the diagram. 


~~ Get Task , Display Task 


(a Capture 

) Don 
er, * Details , _ Details =e” Username © 
Start ———— End 


Gj Complete Later 


(@y) 
wy 


Postpone Task 


k. Click the Capture Username step. 


__|. Enter the code in the Script properties menu to capture the username in the userName1 
variable: 


tw. local.userName1 = tw.system.user.name; 


~ Get Task “Display Task 


— Capture ; O 
) ia 2 Don 

SY °) Details a! Details —eene® Username 

Start i End 


Gj ~Complete Later 


5 a 
@&® 
i 
Postpone Task 
__m. Save your work. 


___ 3. Implement the new service on the process. 


__a. From the history menu, open the Approve Hire Request linked process. 
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__b. On the Variables tab, create a private variable: hrAdmini( String) 


Y Variables | Q. Type to filter 


vy @ Input @ 7 
® isCompliant (String) 
> ® requisitionDetails (HiringRequisition) 
vy © Output @) v 
@ isCompliant (String) 
> © requisitionDetails (HiringRequisition) 


y @ Private ‘S) 
@ hrAdmin1 (String) 
a Exposed Process Variables (+) 


Click the Definition tab. 


d. Click the Override Hire Request in the HR Administrator lane and click the 
Implementation properties menu. Implement the activity with the Override Hire 
Request client-side human service in the Implementation section. 


Override Hire 
Request 


HR Administrator 


< 
General 
Implementation v __ Activity Type 
Data Mapping Type: User Task tA 
Assignments 
Pre & Post Y Implementation 
Tracking 
Implementation: 
Conditions 


__e. Implement the Verify Override Hiring Request activity with the same Override Hire 
Request client-side human service. 
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f. Click the Override Hire Request activity. 


__g. Open the Data Mapping properties menu and map the userName’ output variable to 
the tw. local. hrAdmini(String) private variable. 


Not Accepted Oy 
a a P ; 
— Override Hire Verify Override 
= Request » Hire Request ~ Cn” 

Is Salary 
Acceptable oe, 
Accepts 
| 2 


userName ...c> tw.local.hrAdmin1 & 


__h. Map the userName’ variable of the Verify Override Hire Request activity to the 
tw.local.hrAmdin1 (String) private variable. 


__i. Save your work. 


Part 3: Create the team filter service 


The four eyes principle requires that two people approve some activity. To implement the 
Four eyes policy, you need to know who the previous approver for the activity was, then 
filter that person out using Team Filter services. 


__1. Create a team filter service to assign the second task to the correct pool of users. 


__a. Inthe library, click the plus sign (+) next to the Services category, and then click 
Service Flow. 


User Interface 


Services 


© External Service 


® Web Service 
#& Advanced integration Service 


Teams 


__b. Name the service: Four Eyes Policy 


__c. SelectUse as a team service option. 
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d. Verify that Team filter is set as Service type and Team Filter Service 
Template is set as Template. This template is part of the System Data toolkit. The 
template defines the inputs and output variables that are required for this type of 
service. 


New Service Flow , M 


A service flow lets you build, test, and run a set of services. Learn More 


Name: Four Eyes Policy 


Use as a team service: [Vv] 


Service type: Team filter v 


Template: # Team Filter Service Template System Data 


| FINISH | | CANCEL | 


__e. Click FINISH. 
__f. In the Four Eyes Policy service flow, click the Variables tab. 


__g. Add an input variable: hrAdmini (String) 


Overview Diagram Variables Decisions 
Y Variables Q. Type to filter 
vy @ Input @ 


> & originalTeam (Team) 
v & Output 
> & fitteredTeam (Team) 
@ Private 
a Exposed Process Variables 
© Localization Resources 


OO®@ 


__h. Click the Diagram tab. 


__i. Donotusea Server Scriptlet for this task. Drag a Server Script onto the canvas and 
name the step: Filter Team 
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__j. Connect the flows. 


# Four Eyes Policy v ®) @ Last updated seconds ago 


Overview Diagram Variables Decisions 


6) > Filter Team ~O 
Start End 


__k. Click the Filter Team server script, and then click the Script properties tab. Leave the 
default as Script. 
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__|. Filter the team by adding the following script. Alternatively, you can copy and paste the 
script that is provided in the file Filter JS.txt text file at the location: 
C:\labfiles\Support files\Ex10. 


tw. local.filteredTeam = new tw.object.Team(); 

tw. local.filteredTeam.name = tw.local.originalTeam.name; 

tw. local.filteredTeam.managerTeam = tw.local.originalTeam.managerTeam; 
//copy the original team and then recreate the team members 


tw. local.filteredTeam.members = new tw.object.listOf.String(); 
//iterate through original list 


for (var 1=0; i<tw.local.originalTeam.members.listLength; i++) { 
if (tw.system.org.findRoleByName(tw.local.originalTeam.members[i])) { //team 
var tempTeam = 
tw. system.org.findRoleByName(tw.local.originalTeam.members[i]).users; 
for (var j=0; j<tempTeam.length; j++) { 
if (tempTeam[j].name != tw.local.hrAdmin1) 


tw. local. filteredTeam.members[tw.local.filteredTeam.members.listLength] = 
tempTeam[j ] .name; 


ig 
t 


else { //individual user 
if (tw.local.originalTeam.members[i] != tw. local.hrAdmini) 
//if member is not the hrAdmin member, add member to filtered list 
tw. Local. filteredTeam.members[tw.local.filteredTeam.members.listLength] = 
tw. local.originalTeam.members[i].toString(); 


} 


General 


implementation Y Script ‘@) 


Script Scriptiet 
Script 
i tw.local.filteredteam « new tw.object.Team(); a 
Pre & Post 2 tw. local. filteredTeam.name « tw. local.originalTeam.name; 
tw. local. filteredTeam.managerteam « tw.local.originalTeam.managertTeam; 
/copy the original team and then recreate the team members 
tw. local. filteredTeam.sembers = new tw.object.listof.string(); 
//iterate through original list 
for (var i-0; i<tw.local.originalTeam.members.listLength; i++) (| 
if (tw.system.org. findRoleByName(tw.local.originalTeam.members[{i])) { //team 
var tempTeam « tw. system.org. findRoleBytame(tw. local .originalTeam.members[i]}).users; 
for (var j=0; j<tempTeam. length; j++) { 
i if (tempTeaa[j].name != tw. local. hrAdmini) 
2 tw. local. filteredTeam.members[tw. local. filteredTeam,members.listLength] = tempTeam[j).nas 
3) 
+} 
else { //individual user 
if (tw. local.originalTeam.sembers[i] != tw. local.hrAdmin1) 
‘Jit member is not the hrAdmin member, add member to filtered list 
tw. local. filteredTeam,members[ tw. local.filteredTeam.members.listLength] « tw. local.origir v 
< > 


© Copyright IBM Corp. 2019 10-11 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 10. Implementing the “four eyes” policy by using a team filter 


___m. Save and close the Four Eyes Policy service. 


Part 4: Apply the team filter service to the activity assignment 
__ 1. Apply the team filter service. 
__a. Return to the Approve Hire Request process. 
__b. Click the Verify Override Hire Request activity on the process. 


__c. From the Assignments properties menu, select the Four Eyes Policy as the Team 
Filter service. 


General 
Implementation 
Data Mapping Assign to: Lane v 
Assignments User distribution: None Vv 
Pre & Post Team filter service: yes Policy ‘Select... [ New... | x 
Tracking Experts team: <none> [ Select... ] [_ New... ] x 
Conditions 


__d. Inthe input mapping section for the team filter service on the right, map the 
tw. local.hrAdmin1 variable. 


v Input Mapping 


twlocal.hrAdmint & => hrAdmint (8... 


__@. Save your work. 
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Part 5: Test the four eyes policy 


__ 1. You now test the four eyes policy in the process portal 


__a._ If not already open, click the link to the Process Portal by using the Quick Start menu. 


7) IBM Business Automation Workflow Quick Start 


Ww 
“~ 


IBM Business Automation Workflow Quick Start 


Vor Wren Crronnianee Wat Trarcryvuou QquCUtSe, Tianrage Ua arnorer Crrers, aire tronmmur Urorawr 


performance. A 
Business Performance Admin Console 


Process application consoles & tools 


Create, manage, share, and test high-level containers such as process applications and toolkits. 
Process Center Console 


Test and administer the business user interface for completing tasks. 


Documentation | 
Learn about the capabilities and features of IBM Business Automation Workflow. 
Knowledge Center v 


IBM. 


___b. The Process Portal opens in a new browser tab. Since you were already logged into the 
Workflow Center as author1, the session continues and you are logged into Process 
Portal as author1 also. For the team filtering to work successfully, you need to be logged 


in as a non-administrator user. If logged in as author, log out of Process Portal by 
clicking Log Out. 


author? 


Edit Profile 


. Dashboards 


Create Saved Search 
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__c. Log in to Process Portal using user in the Username field and passwOrd in the 
Password field. Click Continue. 


Sign in to Business Automation Workflow 


Username 


Password 


Continue ©) 


__d. Verify that User is listed at the upper left corner. 


Edit Profile 


Dashboards 


Create Saved Search 


___@. Create an instance of the process by clicking Hiring Request Process in the Launch 
section on the left. Wait for the first task to open in the main window. 


Launch 


&* Hiring Form 


oe Hiring Request Process 


__f. Complete the first task by creating a non-compliant requisition. Use the following values 
for the variables on the form (settings inside the browser in parentheses): 


¢ tw.local.requisitionDetails.position.jobLevel (Position Details > Job Level) set to: 
Manager 


e tw.local.requisitionDetails.recruitingDetails.newPosition (Recruiting Details > 
New Position) set to: false (not selected) 


¢ tw.local.requisitionDetails.compensationDetails.salaryToOffer (Compensation 
Details > Salary to Offer) set to: 100, 000 


__g. Click Submit. 
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__h. When the portal refreshes, the new task Override Hire Request activity is shown in the 
work dashboard. This task is the first task in the four eyes requirement. Click the Step: 
Override Hire Request link to run the task. 


Step: Override Hire Request 
Hiring Request Process:261 

All Users 

Due: May 1, 2019, 12:22:45 AM 


__i. Click Claim Task. 


Claim Task 


= Step: Override Hire Request 


Hiring Request Process:261 

All Users 

May 1, 2019, 12:22:45 AM 
-_ 


This task is still unclaimed. When you open this task, it will be assigned to you. 


[J Don't show me this message again. 
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__j. In the Override Hire Request page, click Done. 


Step: Override Hire Request 


Overview Details 


This is a sample coach for the follon || Step: Override Hire Request 


This coach is just a placeholder, and would be replaced with an approval form. You are 
trying to test the assignment, so ignore the placeholder. 


__k. Wait for the work dashboard to refresh. No other tasks are shown in the dashboard even 
though a second task is created and assigned to the All Users team, but the current user 
user 1 is filtered from the list. As a result, you do not see any task listed in the 
dashboard. 


I. | Click Log Out to logout of the Process Portal. 
m. Log back into the Process Portal, this time as user2. Enter user 2 in the Username field 
and passwOrd in the Password field. Click Continue. 


Sign in to Business Automation Workflow 


Usermame 


Password 


Continue ‘S) 
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n. The task is shown in the Work page. The Verify Override Hire Request task is 
assigned to “All Users,” which is misleading. Although the role might seem to contain all 
users, it is a filtered list. The original approver (user1) is filtered from the All Users list. 
The filter is the reason why the task is not listed in the user1’s work dashboard. The task 
is assigned to a team that filtered out the user who completed the override hire request 
task. In this example, user user1 completed the task of Override Hire Request, so 
user1 is filtered out and cannot complete the Verify Override Hire Request. Click 
Verify Override Hire Request. 


Step: Verify Override Hire Request 
Hiring Request Process:261 
All Users 

> 7 Due: May 1, 2019, 12:24:43 AM 


__ 0. Click Claim Task. 


__p._ Inthe Verify Hire Request coach that opens, click Done. 


Step: Verify Override Hire Request 


Overview Details 


This is a sample coach for the following acti Step: Verify Override Hire Request 


User2 successfully completed the Verify Override Hire Request task. 


__q._ Inthe library on the left, click the link to Log Out of the process portal. 


author 1 


Edit Profile 
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__r. Close the Process Portal. 


Part 6: Export the process application and do cleanup 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Go back to the workflow center and log in using author1 and passwOrd. 
__b. Click the HR Recruitment Process process application. 


__c. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__d. Enter Exercise 10 solution for the name. 
__@. Click Create. 

__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
__a. Click Export next to the Exercise 10 solution snapshot. 


__b. Inthe Export Process App window, click Export. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

() IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


Export 


c. Click OK to save the file. The application is saved to the default folder, which is the 
downloads directory. 


d. Verify that the application is listed to the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a._ Inthe Process Apps tab, click the HR Recruitment Process application. 


__b. Click Manage. 


Process Apps Toolkits Servers 


+2 HR Recruitment Process (HRR) History Manage Governance 


__c._ Inthe right panel, click Archive Process App. 
——— a — SES SSS == 
2 Archive Process App 
@ View Archived Tracks 


d. In the window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


e. Click Process Apps again and then click the Archived link. 


Logged in as authori (author!) | Preferences | Logout 


Sort By. Recently Updated +» All | W& Favorites | Archived 


f. Click Delete. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | w Favorites | Archived 


=z =~ 


___g._ Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


h. Click All to switch back to the Process Apps tab. Note that the HR Recruitment Process 
is no longer listed. 


__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 
__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit toolkit. 
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__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) «> History Manage Governance 


__c._ Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 


@ View Archived Tracks 


__d._ Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 


delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


__@. Click Toolkits again and this time click the Archived link. 


Logged in as author’ (author1)| Preferences | Logout 


Sort By: Recently Updated »~ All | w Favorites | Subscriptions | Shared | Archived 


__f. Click Delete. 


Logged in as author? (author!) | Preferences | Logout 


Sort By: Recently Updated » All | w Favorites | Subscriptions | Shared | Archived 


& Restore | 3 


__g._ Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h._ Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


In the first part of the exercise, you modified the process and service to capture the first 
reviewer user ID. Next, you modified the activity on the process and created a routing policy. 
You tested the routing policy and verified that it filtered out the user from the list of 
participants available to claim the task. 
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End of exercise 
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Exercise 11.Building a cancellation 
pattern 


Estimated time 


01:00 


Overview 


In this exercise, you learn how to implement a cancellation pattern. 


Objectives 


After completing this exercise, you should be able to: 
¢ Implement a cancellation pattern in a process application 


¢ Implement an undercover agent (UCA) to cancel the hiring request 


Introduction 


A general manager requests the ability to cancel a hiring request while waiting for approval from the 
approvers. In this exercise, you create a cancellation message listener inside IBM Business 
Automation Workflow. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 


Part1: Import the process application solution from the previous exercise 


In this section, you import the exercise 10 process application solution that is required to start 
exercise 11. This import ensures that you have a good copy of the process application at the start of 
an exercise. Importing this exercise is optional if you completed the previous exercise successfully 
and you did not archive and delete the process application. 
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This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


++ Create New Process App 
& Import Process App 
$= Download desktop Process 


Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select the HR_Recruitment_Process - 
Exercise_10_solution.twx. 


d. Click OK. 


__e. Inthe Import Process app window, click Import. Make sure that the Open in Process 
Designer option is not selected. 


f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 


___2. Imported toolkits are immutable, which means that no one can change the items within an 
imported toolkit. Administrators can change the immutable quality of a toolkit by enabling 
the Allow users to update toolkit option in the Manage tab for the imported toolkit. You 
must do this step otherwise you cannot make any changes or updates to the toolkit in the 
exercises. Do not skip this step. 


__a. Click Hiring Requisition Toolkit and then click Manage. 
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__b. Click Allow users to update toolkit. This is required for any updates to the toolkit. 


(_] Allow users to update toolkit 


__c. Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise 


Allow users to update toolkit 
LI] Allow users to create tracks in this toolkit 
Why Tracks 


Part 2: Create the event 


__1. Acancellation event must be attached to the Approve Hire Request linked process. 


a. Click the Process Apps tab. 


__b. Click the Open in Designer link next to the HR Recruitment Process (HRR) process 
application. 


__c. Open the Processes > Hiring Request Process in the Designer. 


__d. Drag an intermediate event from the palette and place it on one of the attachment 
points on the Approve Hire Request linked process. Make sure that you attach the 
intermediate event to the Approve Hire Request linked process and not the Approve 
New Hire Request activity. 
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__e. Verify that the attached intermediate event is selected. Change the name of the event 
to: Cancel Approval. 


Definition Variables Folders Views Tracking 


Approve Hire 


Request 


> Approved 


Is Re quest 
Compliant 


on vY Common 
19 Name: Cancel Approval 


__f. From the Implementation properties menu, change the Boundary Event Type to 


Message. 
Overview Definition Variables Folders 
oa Approve Hire 
}: a Request 
Is Request ——S> 
Approved 
< 
General 
Implementation Y Boundary Event Type 
fan Message 
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__g. Create a flow from the attached message intermediate event to the Complete Hire 
Request system lane activity. 


<o> 


Approve Hire 


Request 
a Is Request Request Compliant 
Compliant 
Gy 
Systematic 
Request Start 

Y Vv 
-_ Review 
Request Canceled Posting 

> ; 

> Complete Hire <®@ 
Request 


End 


__h. Save your changes. 


a Important 


If an event changes the flow of a process similar to a cancellation event, you should also include 
some cleanup steps. This approach ensures that the process participants know about the event, 
and participants can react to the event as part of the process. Merely stopping or terminating an 
instance is not an ideal approach. 


Part 3: Create an undercover agent 
__ 1. Add an undercover agent in the library. 


a. Inthe library, click the plus sign (+) next to the Events category, and click Undercover 
Agent. 


b. Name the undercover agent: Cancel Hiring Request 


c. Setthe Schedule Type to: On Event. 
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__d. Click FINISH. 


New Undercover Agent 


Undercover agents (UCAs) are started by an event and invoke a Process. 
UCAs pass data to the Process through an associated service or variable. 


Name: Cancel Hiring Request : 


Schedule Type: |On Event ¥] 


coc 


___2. Configure the undercover agent. 

a. Under the Details section, keep all the default settings. 

b. Verify that the Variable Implementation type is enabled. 
Leave the default Variable Type as NameValuePair. 


d. Verify that the Enabled check box is selected. 


Y Scheduler 


Schedule Type: On Event 


Event Marker: (©) Message [ Setect... 
[ Ru Run in Now 


Queue Name: Async Queue 


Implementation: » Variable Service 


Variable Type: @ NamevaiuePair System Data "Select... 


Enabled: Yj 


Parameter Mapping 


& Input (NameValuePair) 
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__@. Change the Event Message to: CancelHiringRequest. 


Event Messages: CancelHiringRequest 


__f. Save your work. 


Part 4: Implement the boundary event with the UCA 


Create a variable to correlate the UCA. 


a 
Switch to Hiring Request Process in the Designer. 


__a. 
__b. On the Variables tab, create a private variable: cancellationId (String) 
Documentation: BtIu | —— 2 © 2. | c= = 
Variable type: ® String System Data 
List: OC 


2. Configure the boundary event. 
__a._ Click the Definition tab. 
__b. Click the Approve Hire Request boundary event. 


as Request Compliant 


Is Rei juest 
Compliant 


Approve Hire... 


sed 


__c. Click the Implementation properties menu. 
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d. Verify that the Interrupt activity check box is selected. The interrupt activity option 
consumes the token of the attached activity when the event is triggered. Because itis a 
linked process, even if numerous tokens exist inside the linked process, all the tokens 
are closed when the event is triggered. 


General 
implementation Y Boundary Event Type 
Date Mapping Message 
Pre & Post = 
interrupt activity: iv] 
Repeatable 


__e. Inthe Event Properties section, click Select next to the Attached message UCA and 
select Cancel Hiring Request. 


Select Library Item 


Undercover Agent © 


“we Cancel Hiring Request 


‘wt Default BPD Event (Quick Start) 
“wa Systematic Request (UCA) 


f. In the Event Properties section, select the Consume message check box. Consume 
message allows correlation with only a single process instance. If you configure multiple 
event listeners to correlate on the same message, then all events trigger if the 
Consume message check box is not selected. 


v Event Properties 


Attached message UCA: | ~wa Cancel Hiring Request ' 


Condition: 
Consume message: 
Durable subscription: LC 


___g. Save your changes. 
__ 3. Map the elements of the Output (NameValuePair) to simple variables in the process. 


__a. Click the Data Mapping properties menu. 
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__b. From the Correlation variable list, select the value (String) variable. 


Correlation variable: @ v 


Output (NameValuePain | 
Output (NameValueP ea 


ee 


__c. Map the Output.name (String) value to the tw.local.cancellationId variable. 


__d. Map the Output.value (String) to the tw.system.process.instanceld variable. 


Y Correlation and Output Mapping 


Specify the variable that will be used to correlate the incoming event fo the proce 
instance. Then, map the variable to a loca 


es <p that th 
SS, SO [natin 
n 


| variable. You can aiso create additional mappil 
Correlation variable: value (String) 


Output (NameValuePair) 


tw.local.cancellationid 


value (String) tw.system.process.instanceld 


The instance must know which message is targeting it. The messages sent to the UCA 
must contain a value that matches the instance ID of this process instance in order for 
this instance to receive the message. When the Output.value and the instance ID 
correlate, the intermediate event processes the message, and a token flows down the 
path. The user ID that canceled the process is also captured and mapped to a local 
variable. Save your work. 


Part 5: Create the wrapper service 


__1. Create a service to trigger the UCA. 


a. Inthe library, click the plus sign (+) next to the Services menu and create a Service 
Flow. 


b. Name the service: Cancel Hiring Request Trigger 
c. Click FINISH. 
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__d. Drag Intermediate Event on to the canvas. 


Loy 


° 
Ov 


__e@. Change the implementation type to message (sending). 


General 
implementation Y Intermediate Event Type @ 
Data Mapping Message (sending) v 
Pre & Post 


__f. Inthe Event Properties section, click Select next to Attached message UCA and 
select Cancel Hiring Request UCA. 


Y Event Properties 


Attached message UCA: “we Cance! Hiring Request 


Target current snapshot: 


__g. Rename the intermediate message event: Cancel Hiring Request. 


__h. Connect the flows. 


Start Cancel Hiring End 
Request 
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__i. On the Variables tab, create an input variable: input (NameValuePair ) 


Overview Diagram Variables Decisions 


Y Variables Q. Type to filter 


¥ @ Input @ 
> @ input (NameValuePair) 
© Output 
@ Private 
a Exposed Process Variables 


(@ Localization Resources 


OOO®@ 


__j. | Save your changes. 
___2. Map the variable. 
Click the Diagram tab. 


__a. 
__b. Click the Cancel Hiring Request event. 


o 


Click the Data Mapping properties menu. 
d. Map the input of the UCA to the tw.local.input variable. 


General 
Implementation 
Data Mapping Use default tw.local.input 
Pre & Post 


e. Save your work. 


Part 6: Create a test harness 


__1. Adda client-side human service to test the UCA. 


__a. Inthe library, click the plus sign (+) next to User Interface. Click Client-Side Human 
Service. 


© Copyright IBM Corp. 2019 11-11 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 11. Building a cancellation pattern 


__b. Name the service: Cancel Hiring Request Test. Select the Intended for use on 
multiple devices check box. Click FINISH. 


‘ 


New Client-Side Human Service 


The client-side human service enables you to build, test, and run interactive i MM 


tasks, dashboards, or user interfaces for process instances, and is 
optimized to run in a web browser. 


Name: Cancel Hiring Request Test 


|/] Intended for use on multiple devices 


[ ] Use as a nested service 


FINISH | | CANCEL | 


c. Drag a Client-side script from the palette and place it next to the Start event on the 
canvas. Name it: Create NVP 


@ Information 


The abbreviation for name-value pair is NVP for this step. 


___d. Select the coach on the canvas and name it: Test Cancellation 


__e@. Drag a service task from the palette onto the canvas to the right of the coach and name 
it: Cancel Hiring Request Trigger 
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__f. Connect the flows. 


bs ‘ . 
sf) 'e.) 
lan Test = OK Cancel Hiring ~O 
ey, | oar ” Cancellation ~—~—~ Request. 


__g. Click the Cancel Hiring Request Trigger service. Click the Implementation properties 
menu. 


__h._ For the Call a service, click Select, and choose the Cancel Hiring Request Trigger 


service. 
General 
Data Mapping Call a service 
Pre & Post @ Cancel Hiring Request Trigger 
Work with the process instance variables 
__i. Save your changes. 
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__ 2. Implement the Create NVP step on the canvas. 
__a. On the Variables tab, create a private variable: input. 


__b. Select the Show all business objects check box and select the NameValuePair 
variable type for the input variable. 


| Select Library tem 
| 


Business Object 


@ NameValuePair (Deis) 
I 


LES eS 


__c. Verify that the variable is created with the NamveValuePair type and save your work. 


Y Variables Q. Type to filter 


® Input 
@ Output 
vy ©@ Private 


& SApUseU Frveess variavies 


et Environment Variables 


OOO OOO 


@ Localization Resources 


__d. Click the Diagram tab. 


__e. Select the Create NVP script, and click the Script properties menu. 
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__f. Copy the following code and paste it into the code block. Alternatively, you can copy and 
paste the script that is provided in the file CreateNVP. txt text file at the location: 
C:\labfiles\Support files\Ex11. 


tw. local.input = {"name":tw.system.user.name, "value":""}; 


Cancel Hiring 
an Create NVP >» Coach =IoK—— “Request... 20) 
start — = 
General 


Pre & Post This editor uses standard JavaScript syntax. Press Ctrl-space while typing to receive assistance with the script synt 


1// This JavaScript will run within the browser and must use the client-side JavaScript 


2// - To instantiate a complex object: - To instantiat¢ 
3// tw.local.customer = {}; 

4// tw.local.customer.name = “Jane"; tw.local.¢ 
5tw.local.input = {"name":tw.system.user.name, "“value":""}; 


__g. Save your changes. 

___ 3. Build the Test Cancellation coach. 
___a. On the Coaches tab, click the Test Cancellation coach. 
__b. Select Start with a default coach and click OK. 


__c. Highlight the OK control and place the cursor over the top portion of the highlight to 
bring up the (+) plus sign. 


__d. Click the plus sign on the highlighted line to bring up the Palette interface. 


Overview Diagram Variables Coach: Test Cancellation v 


ox 


@ 


__e._ Inthe palette on the right, click the Variables icon. 


Hoe m > h BS | 


Variable ra] 


enter filter text 


yIN aff L 10 Al » 


Alerts Area Chart SDS Badge Bar Chart SDS Breadcrumbs 
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__f. Click the plus sign (+) next to Private > input to expand it. 


__g. Select the value (String) variable to place it on the canvas above the OK button. 


Overview Diagram Variables Coach: Test Cancellation v 
Value 
OK 


__h. Select the Value input control on the canvas. 


__i. Change the input field label to: Instance ID 


General 
Positioning bet Common 
Events Help: oO 
Visibility 


__4. Map the input variable for the Cancel Hiring Request Trigger step on the canvas. 


a. Open the Diagram tab. 
__b. Click the Cancel Hiring Request Trigger service. 


__c. Click the Data Mapping properties menu, and map the tw.local.input private 
variable to the input. 


General 


implementation Y Input Mapping s Y Output Mapping 
Data Mapping &% > input (Na 


Pre & Post 
__d. Save your work. 


Part 7: Test the cancellation UCA 


__ 1. Create an instance of the Hiring Request Process. 


__a. Open the Hiring Request Process 
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__b. Click Run inside the process window to create an instance of the process. 


authoriv = (a) 


__c. The perspective changes to the Inspector tab, and the information bar opens on the 
right. 


__d. The Instance ID in the Process Inspector is listed on the right. You use this number in 
the next step to cancel the instance. 


©) Hiring Request 


Process:303 


Cc Rous & 


Y Details 


Instance ID; 303 
rivveoew mrp. mm now ultment Process 
Status: Active 


___2. Complete the first activity in the process. 


a. Tocomplete the first activity and get to the linked process, make sure that the 
Locations section is expanded. 


b. Click Start to run the Submit Hiring Request task from the Inspector information bar. 


© Submit Hiring Request [Token #4] 
©) submit Hiring Request 35a] > |> 
The task is assigned to author! (author). It ss due in 60 mi 


» 


c. Use the following values for the variables on the form: 


- Position Details > Job Level set to: Manager 
- Recruiting Details > New position set to false (not selected) 
- Compensation Details > Salary to offer set to 100, 000 


d. Click Submit. 


e. When the service completes, close the coach browser window. 


© Copyright IBM Corp. 2019 11-17 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 11. Building a cancellation pattern 


f. When the Inspector refreshes, a token is associated with the Approve Hire Request 
linked process. Next, you cancel the linked process and close all the tokens that are 
associated with the linked process by sending a message to the attached intermediate 
message event. 


__ 3. Trigger the cancellation event on the linked process. 
__a. Open the User Interface > Cancel Hiring Request Test client-side human service. 
__b. Click Run. 


EX °° 


__c._ Input the instance ID that you noted earlier. Click OK. 


Instance ID 


303 


__d. When the service completes, close the window. 
__ 4. Verify that the linked process is canceled. 


a. Return to the Hiring Request Process in the Inspector view. 


b. Refresh the Process Inspector, and verify that the message consumed the token for the 
Verify Override Hire Request linked process and all tokens that are associated with the 
linked process are closed. 


c. Click Start to run the Complete Hire Request activity. 


© Complete Hire Request [Token #21] 
2) Complete Hire Request [372 [> ip 


The task is assigned to author! (author?) It ts due in 57 minules 


d. Click Done 
e. Close the browser window. 
f. Return to the Designer tab. 


All the tasks complete and the process consumes all the tokens in the linked process. 
The process flow travels out of the attached message event to the system lane activity. 
After the Complete Hire Request activity completes, the token moves to the End event 
and the process is complete. The instance status changes to Completed. 
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Part 8: Export the process application and do cleanup 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 
__a. Switch to the Workflow Center. 
__b. Click the HR Recruitment Process process application. 


__c. Click Create New Snapshot on the right side. 


*F Create New Snapshot 


$ Open in Designer 


__d. Enter Exercise 11 solution for the name. 
__e. Click Create. 

__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
__a. Click Export next to the Exercise 11 solution snapshot. 


__b. Inthe Export Process App window, click Export. 


Export Process App x 


Select an export file type. 

(@) IBM Business Automation Workflow export (.twx) 

() IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


Export 


c. Click OK to save the file. The application is saved to the default folder, which is the 
downloads directory. 


d. Verify that the application is listed to the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 
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__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a._ Inthe Process Apps tab, click the HR Recruitment Process application. 


__b. Click Manage. 


Process Apps Toolkits Servers 


+2 HR Recruitment Process (HRR) History Manage — Governance 


__c._ Inthe right panel, click Archive Process App. 
——— a — SES SSS == 
2 Archive Process App 
@ View Archived Tracks 


d. In the window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


e. Click Process Apps again and then click the Archived link. 


Logged in as authori (author!) | Preferences | Logout 


Sort By. Recently Updated +» All | W& Favorites | Archived 


f. Click Delete. 


Logged in as author! (author!) | Preferences | Logout 


Sort By. Recently Updated » All | w Favorites | Archived 


=z =~ 


___g._ Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


h. Click All to switch back to the Process Apps tab. Note that the HR Recruitment Process 
is no longer listed. 


__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 
__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit toolkit. 
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__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) History Manage Governance 


__c._ Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 
@ View Archived Tracks 


d. Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 
delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


e. Click Toolkits again and this time click the Archived link. 


Logged in as author’ (author1)| Preferences | Logout 


Sort By: Recently Updated »~ All | w Favorites | Subscriptions | Shared | Archived 


__f. Click Delete. 


Logged in as author? (author!) | Preferences | Logout 


Sort By: Recently Updated » All | w Favorites | Subscriptions | Shared | Archived 


& Restore | 3 


__g._ Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h._ Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


In the first part of the exercise, you created an attached intermediate event on the process. You 
implemented it as an intermediate message event. You created the enabling service, created the 
on-demand UCA, and then implemented the message service. You then created a service to wrap 
the UCA and created a test harness to trigger the UCA on the coach. 
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End of exercise 
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Exercise 12.Building web service 
connections 


Estimated time 


01:00 


Overview 


In this exercise you learn how to build inbound and outbound web service connections. 


Objectives 


After completing this exercise, you should be able to: 
¢ Create an event-based undercover agent 
¢ Build an inbound web service connection 


¢ Build an outbound web service to message the inbound web service 


Introduction 


The project sponsor identified a requirement to expose a cancellation service to an external 
system. The ability to cancel a request must be enabled internally, but also must be available to 
systems that integrate externally with IBM Business Automation Workflow. 


You must create a cancellation message listener as an inbound web service inside IBM Business 
Automation Workflow. Then, create a web service to test or simulate an external system, which 
connects to the inbound web service. This activity gives you practice in creating web services and 
calling external SOAP services. Even though the message is targeting the localhost, the approach 
and concepts that are used in this activity are the same for an external system. 


Requirements 


Successful completion of exercise 1 is required because you start the environment in that exercise. 
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Exercise instructions 


Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 11 process application solution that is required to start 
exercise 12. This import ensures that you have a good copy of the process application at the start 
of an exercise. Importing this exercise is optional if you completed the previous exercise 
successfully and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


*} Create New Process App 
& Import Process App 


$= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


®@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select the HR_Recruitment_Process - 
Exercise_11_solution.twx. 


d. Click OK. 


__e. Inthe Import Process app window, click Import. Make sure that the Open in Process 
Designer option is not selected. 


__f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 
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___2. Imported toolkits are immutable, which means that no one can change the items within an 
imported toolkit. Administrators can change the immutable quality of a toolkit by enabling 
the Allow users to update toolkit option in the Manage tab for the imported toolkit. You 
must do this step otherwise you cannot make any changes or updates to the toolkit in the 
exercises. Do not skip this step. 


__a. Click Hiring Requisition Toolkit and then click Manage. 


__b. Click Allow users to update toolkit. This is required for any updates to the toolkit. 


L_] Allow users to update toolkit 


__c. Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise 


Allow users to update toolkit 
LJ Allow users to create tracks in this toolkit 


Why Tracks 


Part 2: Create an inbound web service to trigger the UCA 


__ 1. Create an inbound web service. 
a. Click the Process Apps tab. 


b. Click the Open in Designer link next to the HR Recruitment Process (HRR) process 
application. 


a. Open the Processes > Hiring Request Process in the Designer 


b. Inthe Process Designer library, click the plus sign (+) next to the Services category. 


c. Click Web Service. 


«» External Service 


# Service Flow 
a Adva Web Service jon Service 
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d. Name the web service: hiringRequestProcess and click FINISH. 


New Web Service 


An exposed web service enables outside systems to access process application 
functionality through a SOAP-callable web service. 


Name: ‘hiringRequestProcess | 


Click Add (plus icon) under the Operations section and select the Cancel Hiring 
Request Trigger service. 


Y Operations 
® Operations 


_eé. 


f. Under the Operation Detail section, change the Operation Name to: cancel 


Y Operation Detail 


atachedsece: Canc rngRenuetT99e 


II 
ni 

ii 
o 
wl 
v 
Hi 


Documentation: BrlIul\=z=e=z 


12-4 
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__g. Under the Behavior section, verify that the Protected check box is not selected. 


Y Behavior 


Protected: 

WSDL URI: https://WS201 4:9443/teamworks/w 
vices/HRR/hiringRequestProcess.tws?WSD 
L, 

Target namespace scheme: Use process app or toolkit settings v 

Target namespace: http://HRR/hiringRequestProcess.tws 

SOAP version: 1.1 4) 1.2 


__h. Save your work. 
__i. Click the WSDL URI link. 


Y Behavior 


Protected: 
WSDL URI: 


__j. |The WSDL is loaded in your browser. The information about the web service you 
created is shown to include the methods available, the variable inputs and outputs, and 
metadata about the service call. Highlight the address in the browser address bar, 
right-click, and click Copy. 


Https://ws2016x64:9443/teamworks/webservices/HRR/hirin : 
Undo Ctrl+Z 


) have any style information associated with it. The docun 

———- OOO? —_—_—_—__ Cut Ctri+X - 

="http: //HRR/hiringRequestProcess.tws" xmlns:wsdl="F Ctrl+C " 

gRequestProcess.tws" xmlns:xsd="http: //www.w3.org/2€ t 
ihm_com/schema/" ymins:wedlsoant2="httn: //schemas Faste CUl+y v 

__k. The URL is used to define the server setting for the Web Service Integration 
component in the outbound integration in the following steps. 
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Part 3: Test the inbound integration by creating an outbound integration 
__1. Create an outbound integration. 


__a. 


In the library, click the plus sign (+) next to the Services category, and select External 


Service. 


@ Service Flow 


@ Web Service 


a& Advanced Integration Service 


__b. Leave the Java REST or Web service option selected and click NEXT. 
New External Service 


An external service lets you call a service or application that is external to IBM Busit 
Learn More 


® Java, REST or Web service 


Create an external service by discovering a Java, REST or Web service. 


External Implementation 


Create an external service with an External Implementation binding. 


__c. Select Web Service from URL as the method to discover the service. 


__d. For the External service name, enter Cancel Hiring Request WS 
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__e. Inthe URL field, enter the URL that you copied earlier. If needed, switch to the browser 
tab and copy it. 


New External Service 


An external service lets you call a service or application that is external to IBM Business Automation Workflow. 
Learn More 


Select a method to discover the service. 


Web service from URL 


External service name: Cancel Hiring Request WS 
URL: https:/ws2016x64:9443/teamworks/webservices/HRR/hiringRequestProcess.tws?7WSDL 
user name: 
Password: 
__f. Click NEXT. 


__g. Leave the default operation selected and click NEXT. 


New External Service 


An external service lets you call a service or application that is external to IBM Business 
Learn More 


Select the operations to include in the generated external service. 


Operation Name 


ts cancel 


__h._ Leave the default business objects to be created and click NEXT. 


New External Service 


An external service lets you call a service or application that Is external to IBM Business Automatio 
Learn More 


The following business objects will be created for the corresponding XML Schema Type. 


XML Schema Type Business Object 


{http:/ombardi.ibm.com/schema/}NameValuePair NameValuePair 
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__i. Leave the default new server name and click FINISH. 


New External Service 


An external service lets you call a service or application that is exter 
Learn More 


Vv Server 


Select a server for the external service. 


Create a new server 


Server name: CancelHiringRequestWSServer 


Select an existing server 


___2. Create the service flow for the web service. 


a. Inthe library, click the plus sign (+) next to the Services category, and select Service 
Flow. 


b. Name the Service flow: Call Cancellation Service 
c. Click FINISH. 


New Service Flow ’ y 


A service flow lets you build, test, and run a set of services. Learn More 
Name: Call Cancellation Service 


Use as a team service: 
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d. Inthe library, click Services, locate Cancel Hiring Request WS anddragitto the canvas 
for the Call Cancellation Service flow. 


Overview Diagram Variables Decisions 


Start End 


Cancel Hiring 
Request WS 
| enced | 
__e. Connect the flows. 
Overview Diagram Variables Decisions 


Cancel Hirin 
~ iri 
e i Request we TS 50) 


Start End 


__f. Select the Cancel Hiring Request WS service and click the Implementation properties 
menu. 


__g. Inthe Implementation section, change Operation value to cancel. 


Y Implementation 


Implementation: Cancel Hing Reauestwws [Sect ][ New] 
: 


ror: sUap icninngrequestProcessSoap (SOAP 1.2) v 
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__h. On the Variables tab, add an input variable named: requestId (NameValuePair ) 


Overview Diagram Variables Decisions 


Y Variables (Q Type to fitter } 


vy @ Input 
>» @ requestid (NameValuePair) 
© Output 
@ Private 
a Exposed Process Variables 


©@ Localization Resources 


@ 


OOO® 


i. Click the Diagram tab. Click the Cancel Hiring Request WS component. Open the 
Data Mapping properties menu. 


__j. Inthe Input Mapping section, map the tw.local.requestId variable to the input of 
Cancel Hiring Request WS. Leave Input Header Mapping and Output Header Mapping 


blank. 
General 
implementation Y Input Mapping => 
Data Mapping tw.local.requestid & <> input (NameVal 
Pre & Post 


Y Input Header Mapping 


& — Request SOAP 


__k. Save your work. 
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__ 3. Verify the new server that you just added. 


__a. Click Process App Settings. 


# Call Cancellation Service v «®) 
[% Process App Settings 


@B hiringRequestProcess ®) 
# Cancel Hiring Request WS «®) 
© Call Cancellation Service ®) 


User Interface 


__b. Click the Servers tab and verify that the new server CancelHiringRequestWSServer is 


listed. 
Overview Environment Variables Servers 
v Servers 
CancelHiringRequestWSServer 


__c._ Inthe Details section, scroll to the bottom and examine the WSDL URL that you used 
earlier to create the web service. 


Default @ 


WSDL URL @ https://ws2016x64:9443/teamworks/webser 
Protected WSDL: 

emar¢me 
Passw } (js) 


Discover 


Override Endpoint 


nt Port 


Security and Policy Use Basic Security v 


Bh ee 
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Part 4: Test the integrations 


__ 1. Modify the Cancel Hiring Request Test service to cancel an instance with a UCA or a web 
service call. 


__a. Open the User Interface > Cancel Hiring Request Test client-side human service in 
the Process Designer. 


__b. Adda private variable: webCall (Boolean) 


SL 


Name: webCall 
Documentation: BI Ue 2S 2:25 =le<e 
Is list O 


Variable type: @ Boolean System Data| Select... New. 


__c. Click the Coaches tab and click the Test Cancellation coach. 
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___2. Create a control on the page to allow users to select the type of test to perform. 
Highlight the OK control and place the cursor over the top portion of the highlight to 
bring up the (+) plus sign. 

__b. Click the plus sign on the highlighted line to bring up the Palette interface. 


__a. 


Coach: Test Cancellation V 


Overview Diagram Variables 
Instance ID 
—_—_— ! 
OK 
@ 
__c._ Inthe palette on the right, click the Variables icon. 
Bo ah 
| Variable oO 


enter filter text 


yiX a C10 ll & 


Alerts Area Chart SDS Badge Bar Chart SDS Breadcrumbs 
| 


__d. Click the plus sign (+) next to Private > input to expand it and click webCall. 


Hon mS hh BO @ 


@ Input 
@ Output 
@ Private 
@ input (NameValuePair) 
@ name (String) 
@ value (String) 


@ webCall (Boolean) 


(@ Localization Resources 
___@. Change the Web Call control label to Type of Test. 
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__f. Inthe General > Behavior section, click Select for View and change the type to 
Switch. 


Vv Behavior 


Binding: @ webCall (Boolean) 
View [switch (Boolean) UI Tootkt 


Label visibility: @ Show Vv 


__g. Click the Configuration menu and expand Appearance. 
__h. Set On label: Web Service 
__i. Set Off label: UCA Message 


General 
» Appearance 


Positioning 
Color style: © Default 


Configuration 
Shape style: © Default 


aan Size: © T= Defauit 
Visibility Label type: © Text 
HTML Attributes On label: © Web Service 


Offiabe: © UCA Message 


__ 3. Add the Cancel Hiring Request WS service to the service flow. 


a. Click the Diagram tab. 


__b. Drag a service from the palette right above the Cancel Hiring Request service step on 
the canvas. 


c. Name it: Cancel Hiring Request WS 


__d. Under the Implementation > Behavior section, ensure that Call a service is selected. 
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__@. Click Select and under the Integration Service category, select Call Cancellation 
Service. 


Y Behavior 


© Call a service 


Work with the process instance variables 
Refresh the instance variables v 


Map input data automatically: ¥ 


__f. Openthe Data Mapping properties menu, and map the tw. local. input variable to the 
requestld input variable. 


General 
implementation Y Input Mapping S 
Data Mapping tw.local.input & <> requestl.. 
Pre & Post 


___ 4. Route the flow dependent on which type of test the user selects. 


__a. Add an Exclusive Gateway to the right of the Test Cancellation coach, and name it: 
Type of test 
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b. Create a flow from the gateway to Cancel Hiring Request WS, and name this flow: web 
Service. Select the Name visible check box. 


——— 
= 


Web Service D> Cancel Hiring 


Request WS 
Type of test 
Cancel Hiring >C) 
———_———_> 
9 OK Request... 


End 


c. Create a second flow from the gateway to the Cancel Hiring Request Trigger service, 
and name this flow: UCA. Select the Name visible check box. 


Cancel Hiring 


Web Service — Request WS 
Type of test 
Test ancel Hiring >~C) 
> Cancellation ~~ — OK > Request... 


— End 


__d. Delete the flow from the Test Cancellation coach to the Cancel Hiring Request 
Trigger Service. 


__e. Connect the flow from the Test Cancellation coach to the gateway. 
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__f. Connect a flow from Cancel Hiring Request WS to the End event. 


Cancel Hiring 


aa Request WS 
S res) 4a 
>> Test 
OK 
\ayp? ® Create NVP e Cone Sj x» 
Start ———E Type of Test 4 
: Cancel Hiring 
_ > Request... 


__ 5. Configure the gateway. 
a. Click the Type of test gateway. Click the Implementation properties menu. 


b. Implement the decision gateway by making the UCA flow the Default Sequence Flow. 
This flow connects to the Cancel Hiring Request Trigger service. 


c. Enter tw.local.webCall in the Web Service path, select == from the operands menu, 
and enter true in the last field. 


General 
Implementation Y Decisions 
Pre & Post Web Service: tw.local,webCall 


Default flow: UCA 


__d. Save the service. 
___6. Test the outbound web service call. 
__a._ Inthe Process Designer, open the Hiring Request Process. 
__b. Create an instance of the process by clicking Run. 
c. Run the Step: Submit Hiring Request activity. 
d. Use the following values for the variables on the form: 
- Position Details > Job level set to Manager 
- Recruiting Details > New Position set to false (not selected) 
- Compensation Details > Salary to offer set to 100, 000 
e. Click Submit. 


f. Close the browser window. 
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__g. Refresh the instance details until you see that the Override Hire Requests task 
appears in the Locations section of the information window. Note the instance ID. 


6) Hiring Request 
Process:307 


Instance ID: 307 
Frocess App: HR Recruitment Process 
h. Return to the Designer view by clicking the Designer tab. 
i. Open the Cancel Hiring Request Test client-side human service. 
__j. Click Run. 
k. Select the Web Service option. 
|. Enter the Instance ID and then click the Web Service option. 
m. Click OK. 


A Not secure | Attps://ws2016x64:9443/ 


Instance ID 


__n. Close the service window and return to the Hiring Request Process. 


__ 0. Click the Inspector tab. 
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__p. Refresh the instance details window. Verify that the message event consumes all the 
tokens inside the linked process and moves the process down the message event flow. 
The instance moves from the Override Hire Requests task and is at the Complete Hire 
Request step. Feel free to complete the task. 


) Hiring Request 


Process:307 


CHO B ¢ 


\ Details 


Instance ID: 307 
Process App: HR Recruitment Process 


Status: Active 

Start time: May 2, 2019 1:23 PM (6 
minutes ago) 

Last action: May 2, 2019 1:29 PM (> 1 
minute ago) 

Due date: May 2, 2019 9:23 PM (in 8 
hours) 


> Tasks (4) 


> Message events (1) 


VY Locations 


7 © Complete Hire Request [Token #21 
8 Complete Hire Request [37 | . 


This completes this exercise. 


Part 5: Export the process application and do clean up 


Now that this exercise is complete, you are ready to export the process application. This export 
saves your application as a twx file in a folder and you can review it or use it later, if needed. After 
exporting this process application, you archive and then delete it from the Workflow Center. 


Keep in mind that in the next exercise, you import a working process application solution to ensure 
a good starting application state for successful completion. This process helps you to continue 
working with exercises without any interruption from an unresolved error in any of your previous 
exercises. Additionally, it also helps in making this course modular as you can then work on any 
exercise in any order (Although, for a good learning experience, it is highly recommended to do the 
exercises in the order they are provided). 


__ 1. Create a snapshot 


__a. Click the HR Recruitment Process process application. 
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__b. Click Create New Snapshot on the right side. 


+ Create New Snapshot 


Open in Designer 


__c. Enter Exercise 12 solution for the name. 
__d. Click Create. 
__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
__a. Switch to the Workflow Center. 
__b. Inthe Process Apps tab, click the HR Recruitment Process application. 
__c. Click Export next to the Exercise 12 solution snapshot. 


__d. Inthe Export Process App window, click Export. 


Export Process App x 


Select an export file type. 

(©) IBM Business Automation Workflow export (.twx) 

(_) IBM Business Automation Workflow Installation Package (.zip) 
©) BPMN 2.0 export (.zip) 

©) SAP Solution Manager (deprecated) 


Export 


__@e. Click OK to save the file. The application is saved to the default folder, which is the 
downloads directory. 


__f. Verify that the application is listed to the downloads directory. You do not need to use 
this application and it is there for your use or review later, if needed. 


__ 3. Archive the process application and delete it. Before you can delete an application, it must 
be archived first. 


__a. Inthe Process Apps tab, click the HR Recruitment Process application. 


__b. Click Manage. 


Process Apps Toolkits Servers 
#2 HR Recruitment Process (HRR) History | Manage — Governance 
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c. Inthe right panel, click Archive Process App. 
———— >> — === 
@ Archive Process App 
@ View Archived Tracks 


d. In the window that opens, click Archive to confirm the action. Clicking Archive, does 
not delete the application; it removes it from the available Process Apps and makes it 
ready for deletion. 


e. Click Process Apps again and then click the Archived link. 


Logged in as authori (author!) | Preferences | Logout 


Sort By. Recently Updated +» All | W Favorites | Archived 


f. Click Delete. 


Logged in as author! (author!) | Preferences | Logout 


Sort By: Recently Updated » | All | W Favorites | Archived 


=| x 


___g._ Inthe window that opens, click Delete to confirm the deletion. The process application is 
now deleted. 


h. Click All to switch back to the Process Apps tab. Note that the HR Recruitment Process 
is no longer listed. 


__ 4. Archive the toolkit and delete it. Before you can delete a toolkit, it must be archived first. 
__a._ Inthe Toolkits tab, click the Hiring Requisition Toolkit toolkit. 
__b. Click Manage. 


Process Apps Toolkits Servers Admin 


@& Hiring Requisition Toolkit (HRT) | Snapshots | History Manage Governance 
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c. Inthe right panel, click Archive Toolkit. 


2 Archive Toolkit 
@ View Archived Tracks 


d. Inthe window that opens, click Archive to confirm the action. Clicking Archive does not 
delete the toolkit; it removes it from the available Toolkits and makes it ready for 
deletion. 


e. Click Toolkits again and this time click the Archived link. 


Logged in as author1 (author1)| Preferences | Logout 


Sort By: Recently Updated ~ All | w Favorites | Subscriptions | Shared | Archived 
__f. Click Delete. 


Logged in as author’ (author!) | Preferences | Logout 


Sort By. Recently Updated ~ All | w Favorites | Subscriptions | Shared | Archived 


& Restore | 3 


g. Inthe window that opens, click Delete to confirm the deletion. The toolkit is now deleted. 


__h._ Click All to switch back to the Toolkits tab. Note that Hiring Requisition Toolkit is no 
longer listed. 


This concludes the solution export and cleanup. 


In the first part of the exercise, you created an inbound integration by using an existing 
generic system service to implement the service. You viewed the WSDL in the browser. 
You then created an outbound web service to test the inbound web service integration. 
You configured the outbound web service, discovered the endpoint methods, and 
selected the method to call. Finally, you modified an existing test harness to call both the 
internal UCA and the outbound web service to test the ability to cancel an in-flight 
process. 


End of exercise 
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Exercise 13.Handling content events ina 
process 


Estimated time 


01:30 


Overview 


In this exercise you learn how to implement a content event in a process. 


Objectives 


After completing this exercise, you should be able to: 
e¢ Use the CMIS capabilities of IBM Business Automation Workflow 
¢ Implement a content event in a process 
e¢ Use the BPM document store to add a document to a process 


¢ Use the Case Manager target object store to share documents between a BPM solution and a 
Case solutions 


¢ Build a simple HR Case solution and create an activity to start the Hiring Request Process in 
the HR BPM solution 


¢ Demonstrate integration between the Case solution and the BPM solution 


Introduction 


In this exercise, you create a content start event that starts the Hiring Request Process when a 
document is received. You also create a startable service that provides the capability to add a 
document to the BPM document store. 


After building the solution to use the BPM document store, you then configure the solution to use 
the Case Manager target object store and demonstrate sharing documents between a Case 
solution and a BPM solution. You then build a simple Case solution and add the Hiring Request 
Process as an activity. You also demonstrate the integration between a Case solution and the BPM 
solution by adding a document to the Case and verifying that the Hiring Request Process was 
started. 


Requirements 


Successful completion of exercise 1 because you start the environment in that exercise. 
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Part 1: Import the process application solution from the previous exercise 


In this section, you import the exercise 12 process application solution that is required to start 
exercise 13. This import ensures that you have a good copy of the process application at the start 
of an exercise. Importing this exercise is optional if you completed the previous exercise 
successfully and you did not archive and delete the process application. 


This import also helps in making this course modular as you can then work on any exercise in any 
order (Although, for a good learning experience, it is highly recommended to do the exercises in the 
order they are provided). 


__ 1. Import the application. Importing the application also imports the toolkit that it depends on. 


__a. Inthe Process Apps tab, in the right panel, click Import Process App. 


“+ Create New Process App 
® Import Process App 


= Download desktop Process 
Designer (deprecated) 
Learn more 


__b. Inthe Import Process App window, click Browse. 


Import Process App 


@) File: 
Select a file to import: 
Browse... No file selected. 


_) SAP Solution Manager (deprecated) 


c. Browse toC:\labfiles\Solutions and select the HR_Recruitment_Process - 
Exercise_12_solution.twx. 


d. Click OK. 


__e. Inthe Import Process app window, click Import. Make sure that the Open in Process 
Designer option is not selected. 


__f. When the import is completed, verify that the HR Recruitment Process application is 
listed in the Process Apps tab. 


__g. Click the Toolkits tab and verify that the Hiring Requisition Toolkit is listed. 
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___2. Imported toolkits are immutable, which means that no one can change the items within an 
imported toolkit. Administrators can change the immutable quality of a toolkit by enabling 

the Allow users to update toolkit option in the Manage tab for the imported toolkit. You 

must do this step otherwise you cannot make any changes or updates to the toolkit in the 


exercises. Do not skip this step. 
__a. Click Hiring Requisition Toolkit and then click Manage. 
__b. Click Allow users to update toolkit. This is required for any updates to the toolkit. 


L_] Allow users to update toolkit 


__c._ Verify that the Allow users to update toolkit option is selected before continuing to the 
next part of this exercise 


Allow users to update toolkit 
C] Allow users to create tracks in this toolkit 


Why Tracks 


Part 2: Implement a document start event on a process by using the BPM 
document store 


1. Change the name of the start event on the process. 


__a. Open the HR Recruitment Process (HRR) process application. 
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__b. Open the Hiring Request Process. Click the Systematic Request Start event. 


4 


Review = 
Posting | 
Systematic 
Request Start 
anceled 
: yY ¥ 
> 
Complete Hire ~C) 
& 
Request 
End 


View the process on the Definition tab. The process has a Systematic Request Start 
that creates an instance of the process on a periodic basis. Management wants an 
employee application document that is uploaded to the repository to automatically 
trigger an instance of the process. 


c. From the General properties menu, change the name of the event to Hiring Request 
Document Start. 


General 
Implementation 
Pre & Post 811ddf52-00ea-4656-8796-39370ab6 1f3f 


__d. Save your work. 
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__ 2. Create a dependency to the Content Management toolkit snapshot. 


__a. Open the library on the left and click the plus sign (+) next to the Toolkits category, then 
click the 8.6.0.0 snapshot under Content Management. 


Add Dependency 


Coaches (deprecated) Oo 


Services 


& 8.6.0.0 
Events Content Management 6 
& 8.6.0.0 
Teams 
Dashboards 
Data && 8.6.0.0 
Responsive Coaches (deprecated) 0 
Performance 
& 8.6.0.0 


Files SAP Guided Workflow (deprecated) @ 


& 8.6.0.0 
Toolkits 


System Governance o 


Hiring Requisition Toolkit (_.. & 8.6.0.0 


System Data (8.6.0.0) 


UI Toolkit (8.6.0.0) 
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__ 3. Create a new event subscription. 


__a. Inthe library, click the plus sign (+) next to Events and then click Event Subscription. 
Hiring Request Process\ v ®) @ Last updated seconds ago by you 


HR Recruitment Process Overview Definition Variables Folders 


Processes 


User Interface 


Services 


a a 


“wa Undercover Agent 


i» Event Subscription 


Teams 


Data 


__b. Name the event subscription Hiring Request Document Start and click FINISH. 


An event subscription obtains information about document events that 
occur on an Enterprise Content Management (ECM) server. 


New Event Subscription 7 


Name: |Hiring Request Document Start 


__c. The event subscription opens in Process Designer. On the right, in the Details section, 
select BPM document store for the ECM Server setting. Leave the rest of the settings 
as the default. 


© Copyright IBM Corp. 2019 13-6 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 13. Handling content events in a process 


__ 4. Create and attach the Service Flow to invoke the Undercover agent. 


__a.  Atthe bottom of the Details section, click the New button next to Attached Service. 


Y Details 


ECM Server: BPM document store v 


Learn More 
Use the Process Application Settings editor to add a server 
Event Class: Document 


Mot 


Object Type: IBM Business Automation Workflow Document Attachnw 


Include Subtypes: 


Event Type: Created 


Attached Service: <none> | Select... New... 


Test Subscription... 


Event Broadcasters: @BAllUsers SystemData Select... New... * 


__b. Name the New Service Flow as Hiring Request Document Start. 


___c. Leave the options as default and click FINISH. 


New Service Flow 


A service flow lets you build, test, and run a set of services. Learn More & 
Name} |Hiring Request Document Start 


©) Create a service that directly invokes a Content UCA 
Create a service that queries the ECM server before invoking a Content UCA 
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Exercise 13. Handling content events in a process 


When you chose the first option, the system creates a fully implemented service and opens 
it in IBM Process Designer. The service consists of a Start event, an End event, and an 
intermediate Send Message Event that invokes the new content undercover agent (UCA). 


Start 


¥ 


Ly 

° 
End @y 

Ov 


General 


Implementation Y Event Properties 
Data Mapping Attached message UCA: ~wa Hiring Request Document Start 


Pre & Post Target current snapshot: ia 


d. Click the Variables tab. 


e. The system created an input variable contentEvent(ECMContentEvent ). The system 
requires this type of variable when the content start event is triggered. When you trigger 
the UCA, it creates an instance of a process. 


Y Variables | Q. Type to filter 


vy @ Input 
y @& contentEvent (ECMContentEvent) 
@ sernerName (String) 
@ repositoryld (ECMID) 
@ eventClass (ECMEventClass) 
@ objectTypeld (ECMID) 
@ eventType (ECMEventType) 
@ objectid (ECMID) 
@ relatedObjectid (ECMID) 
@ relatedObjectTypeld (ECMID) 
@ relatedObjectClass (ECMEventClass) 
@ Output 
@ Private 
2 Exposed Process Variables 
Localization Resources 
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Exercise 13. Handling content events in a process 


f. Return to the Diagram tab. 
__g. Click the Send Message Event on the canvas. 


h. Open the Data Mapping properties menu. The tw. local.contentEvent variable is 
already mapped for you. 


Y Input Mapping 


Use default tw.local.contentEvent & c Input (ECMContentEvent 


__i. Open the Implementation properties menu and click the Hiring Request Document 
Start link for the undercover agent to open the UCA. 


Y Event Properties 


Attached message UCA: ~wa Hiring Request Document Start] Select... J[_ New... ] 


Target current snapshot: 


The Undercover Agent is already configured for you. Under the Scheduler section, you 
see that the Event Marker is Content, which makes it available to implement a Content 
Start Event. Under the Details section, you see the same business object that is used in 
the service flow. The Undercover Agent requires an input variable of type 
ECMContentEvent, and this variable is sent to the process that triggers the Undercover 
Agent. 


Y Scheduler 


Schedule Type: On Event 


Event Marker: [PS] Content 


Queue Name: Async Queue v 
Implementation: ©) Variable Service 
Enabled: 

| ParameterMapping 


& c> Input (ECMContentEvent 


Y Parameter Mapping 


The warning symbol is present to indicate that no mapping has been implemented. With no 
mapping implemented, the default mapping takes place. 
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Exercise 13. Handling content events in a process 


__j. Always change the event message to better identify UCA events that occur in the logs. 
You should always change the event message identifiers from the default hash to a 
relevant event label when creating undercover agents. At the bottom, in the Event 
section, change the Event Message for the UCA to HiringRequestDocumentStart. 


Event Messages: HiringRequestDocumentStart 


__k. Save your work. 
__5. Configure the start event 
__a. Return to the Hiring Request Process and open the Definition tab. 


__b. Select the Hiring Request Document Start event. 


Review 
Posting 


Hiring Request 
Document Start 


Request Canceled 


__c. Click the Implementation properties menu. Change the Start Event Type to ECM 
Content. 


__d. Select the Hiring Request Document Start undercover agent. 


General A 


Implementation v Start Event Type @ 


Data Mapping © ECM Content o 
Pre & Post 


Tracking Y_ Event Properties 
Attached content UCA: | -waHiring Request Document Start 


Condition: 1 


Consume message: UO 
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Exercise 13. Handling content events in a process 


__e. Click the Variables tab. Click the plus sign (+) to create a private variable. 


Y Variables [A Typetofilter 
~® Input @ 7 
© Output @ 


y @ Private x 
Jb 


@ isNewPosition (String) 
@ isApproved (String) 
@ isCompliant (String) 
> @ requisitionDetails (HiringRequisition) 
2 Exposed Process Variables @ 


__f. Name the variable content. Next to the Variable type option, click Select. 


__g. Select the Show all business objects check box, then select ECMContentEvent. The 
content (ECMContentEvent ) variable is complete. 


Select Library Item 


Business Object & 


QO COMChaicanntian (Cantant\ 


@ EcCMContentEvent (Content) 


W ECMContentStream (Content) 
Show all business objects 


__h._ Return to the Definition tab. 
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Exercise 13. Handling content events in a process 


__i. Open the Hiring Request Document Start event and go to the Data Mapping 
properties menu. Map the output of the start event to the tw. local.content private 
variable. There is no need to map the parameters. 


v Output Mapping 
Output (ECMContentEvent) > tw.local.content ’ 


serverName (String) 
repositoryld (ECMID) 


eventClass (ECMEvent... 
objectTypeld (ECMID) 
eventType (ECMEventty... 
objectid (ECMID) 


__j. Save your work. 


__6. Test your solution by running the Undercover Agent. 


__a._ Return to the Undercover Agent by clicking Events > Hiring Request Document Start 
UCA in the Process Library. 


au 


Teams Event Subscription 


€> Hiring Request Document Start 


Data 
Undercover Agent 


‘we Cancel Hirina Reauest 


Performance 
‘*® Hiring Request Document Start 


‘we Systematic Request (UCA) 


Files 
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Exercise 13. Handling content events in a process 


__b. Click Run Now. 


_C¢. 


dd: 


Y Scheduler 


Schedule Type: On Event 


Event Marker: [PS] Content 


Queue Name: Async Queue v 
Implementation: © Variable Service 

Variable Type: @ ECMContentEvent Content Management Select. New... 
Enabled: !M 


Y Parameter Mapping 


& c> Input (ECMContentEvent) 


Click the OK button on the Information window when it confirms that the UCA is 
scheduled for immediate execution. 


bi Information 


The UCA has been scheduled for immediate execution. 


Verify the creation of a Hiring Request Process instance by clicking the Inspector tab, 
then click the Search icon. 
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Exercise 13. Handling content events in a process 


__e._ If the instance you created is not shown, click the Search button. 
Search Q 


Welcome to the Process Inspector 


Filter process instances by Use the Process Inspector to view the task, activity, and data details of one or more process instances. 


™ Status Start by filtering the search so that it shows only the process instances that you are interested in, and then click 
(Active Search. In the results area, select one or more process instances. You can narrow the results by applying more 
[Completed filters and then clicking Refresh. 
L)Failed If you select one process instance, you can see the details for that instance. The tasks and activities areas show 
(_] Suspended the actions that you can perform. The data area shows the data for that instance. 
(Terminated 

If you select multiple process instances, you can see the combined details of the selected instances. The tasks 
rye ity ty and activities areas show the actions that you can perform on all of the selected process instances. 

everi pe 

Doron Learn More... 


Name or user name 


Last modified date 


From Dste Time 


Search 


You created an instance of the process, but you didn’t upload a document to create an 
instance of the process. You create the client-side human service to upload your document 
next. Depending on the number of process instances, the screen capture might not match. 


Showing 1 of 1 instances 
Search Q Select shown instances | Select all instances | Clear selection 


ae eee er erares rtrecereennenceoeree  etreteree ese nttnas enema rare A eee rtnt eenereretieeee Sort by:| Date of last action v 


Filter process instances 
by 


= Status 
(Active (1) 

(J Completed (0) 
(Failed (0) 

(J Suspended (0) 
(J Terminated (0) 


+ Severity type 
Person 


Name or user name 


Last modified date 
From Dste Time F 


To | Date Time » 


__ 7. Create a client-side human service to trigger the UCA 


__a. Switch back to the Designer tab. 


INSPECTOR 
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Exercise 13. Handling content events in a process 


__b. Inthe IBM Process Designer library, click the plus sign (+) next to User Interface, and 
then click Client-Side Human Service. 


© Hiring Request Process v ®) @ Last updated 16 hours ago by you 


HR Recruitment Process Overview Definition Variables Folders | 
| 


Processes 
cee a | 
Client-Side Human Service 


Services & Heritage Human Service 
@ Theme 

View 

Localization Resource 


Events 


Teams 


c. Name the service Hiring Request From Document. Select the Intended for use on 
multiple devices check box and click FINISH. 


New Client-Side Human Service 


The client-side human service enables you to build, test, and run Ted 


interactive tasks, dashboards, or user interfaces for process instances, 
and is optimized to run in a web browser. 


Name_| [Hiring Request From Document | 
Intended for use on multiple devices 


[_] Use as a nested service 
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Exercise 13. Handling content events in a process 


Qe Information 


If you forget to select the check box during the initial creation, or if you decide later to change to a 
responsive coach, you can change the service. You can mark any Client-side Human Service as a 
responsive coach service in the Overview tab of the service. Select the Intended for use on 
multiple devices check box in the Common section. By selecting Intended for use on multiple 
devices check box, you are enabling the responsive capabilities on the coach. 


Diagram Variables Coach: Coachyv 


Name: Hiring Request From Document 
Label 
Documentation: BIU/Z SSBF El SE 


Intended for use 


on multiple devices: 
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Exercise 13. Handling content events in a process 


__d. Click the Variables tab. 


__e. Create a private variable and name it document (ECMDocumentInfo). 


Y Details 


Documentation: BI U | 


Is list: im 


Variable type: @ECMDocumentinfo ContentManagement| Select... | New... 


Be sure to choose the ECMDocument Info variable type and not the ECMDocument 
variable type. 


__f. Save your work. 
__ 8. Create the coach 


__a. Click the down arrow next to Coach and select Coach. 


Overview Diagram Variables Coach: Coach v 
Coach 


Y Variables Q. Type to filter 


~® Input 
@ Output 
vy © Private 
» @ document (ECMDocumentinfo) 
a Exposed Process Variables 
2 Environment Variables 


OOO OOO 


Localization Resources 
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Exercise 13. Handling content events in a process 


__b. Leave the default as Start with a default coach and click OK. 


Select a Template 


@ Start with a default coach 
© Start with a grid: jm Single Column v 


Selecttemplate: v 


c. Place the cursor over the top portion of the highlight for the OK button to bring up the (+) 
plus sign. Click the plus sign to bring up the Palette interface 


d. There is an additional tab in the Palette for Content. Click the Content tab and select 
BPM Document List. 


Hoo B OM > | 2 )@ be 


lenter filter text 5 L 


m ® = a = 


BPM Document BPM File BPM File BPM File 


List Dropzone i Properties Revisions 
rc) el py Ey = 
BPM File Document Document ECM Document ECM File List 
Uploader Explorer Reference List 
ECM File ECM File ECM File d ee 
: i ECM Folder List File Viewer 
Properties Revisions Uploader 


When you added the Content Management Toolkit as a dependency, the palette was 
updated to include controls from the Content Management Toolkit. 
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Exercise 13. Handling content events in a process 


__@e. Inthe General > Behavior properties section, verify that the binding is set to document 
(ECMDocumentinfo). 


Y Behavior 
Binding: @ document (ECMDocumentinfo) 


View: (zs)BPM Document List (ECMDocumentinfo) Content Management 


Label visibility: @ show v 


__f. Click the Configuration properties menu. 


__g. Expand the Content management section and Select the Allow create, Allow updates, 
Allow document deletions, and Confirm on deletion check boxes. 


General “ 


Positioning 


* Content management 


Configuration 
Allow create: 

Events 
ead Allow updates: 

Visibility 
Allow document deletions: 

HTML Attributes 
Confirm on deletion: 


eoooo0o00oo 


Allow revisions display: ia 

Max results: 

Associated with process instance: O 

Match rule: None ¥ 

> Filter: © 

Default upload name: © 

User editable: © oO v 


__h. Save your work. 
__ 9. Configure the coach as a Startable Service. 


Since the Hiring Request From Document client-side human service is not part of the 
process, there is no need to link it to an activity in the process. In order to allow Process 
Portal users to start the service, you configure it as a Startable Service. 


__a. Select the Overview tab for the Hiring Request From Document client-side human 
service. 
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Exercise 13. Handling content events in a process 


__b. Under the Usage section, select Startable Service (Launched from Process Portal) 
for how it is to be used. 


Lt 


Nested service: J 


Use as: Startable Service (Launched from Process Portal) v 


Expose to start: 42 All Users System Data x 


All Users is automatically added as the Expose to start selection. This allows all users 
of the Process Portal to run the Startable Service. 


__c. Save your work. 


___ 10. Upload a document by using the coach. 


___a. Open Process Portal in another tab. The Hiring Request From Document is displayed 
under the Launch menu. 


__b. Click the Hiring Request From Document startable service in the Launch menu. 


Launch 


Advanced HR Open New 
Position 


Discover BPM UI 


Hiring Request Process 


ReplenishmentBPD 


Standard HR Open New Position 
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Exercise 13. Handling content events in a process 


__c._ Inthe Hiring Request From Document coach, click Add. 


Hiring Request From Document 


BPM Document List ZS Refresh | + Add... 


Name :_ Filename or URL + Major Version Number Last Modified Modified By 


> 


__d._ Inthe dialog box, click Select and navigate to the following file: 
C:\labfiles\Support files\Ex13\Employment application. pdf 
__@. Click Upload. 


FILE ’ 


& = Select... Employment application. pdf 


Employment application. pdf 


Upload 
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Exercise 13. Handling content events in a process 


After the upload completes, the document list is refreshed. 


Hiring Request From Document 


BPM Document List Z Refresh Add... 
| Name + File name or URL + Major VersionNumber LastModified + Modified By < | 
| Employment application.pdf | 1.0 | 5/1/2019 | author1 | Of 
OK 


__f. You see a notice in the lower right of the screen that you received a new task. 


__ 11. Verify the document start event works 


__a. Click OK to close the service. The Work page is displayed with a new work item. 


41 On Track 
Total 0 At Risk 


Open 0 Overdue 


Step: Complete Hire Request 


Hiring Request Process:270 
Due: May 1, 2019, 2:59:00 PM 


@ Troubleshooting 


If the work item is not listed, press F5 to refresh the page. 


__b. Return to the tab with IBM Process Designer and click the Inspector view. 
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Exercise 13. Handling content events in a process 


__c._ Ifthe instance you created is not shown, click Search. If there are process instances in 
the list, click Refresh. 


= Status 
[Active 

[_] Completed 
[] Failed 

[-] Suspended 
Terminated 


+ Severity type 


Person 


Last modified date 


From Dste 


Filter process instances by 


a | Welcome to the Process Inspector 


Use the Process Inspector to view the task, activity, and data details of one or more process instances 


Start by filtering the search so that it shows only the process instances that you are interested in, and then click 
Search. In the results area, select one or more process instances. You can narrow the results by applying more 
filters and then clicking Refresh. 


If you select one process instance, you can see the details for that instance. The tasks and activities areas show 
the actions that you can perform. The data area shows the data for that instance. 


if you select multiple process instances, you can see the combined details of the selected instances. The tasks 
and activities areas show the actions that you can perform on all of the selected process instances. 


Learn More 


Search 


__d. Click the newly created Hiring Request Process instance that got added to the 
instance page. The latest instance is the one with the highest instance ID. 
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Exercise 13. Handling content events in a process 


__@. Scroll down in the right pane and expand the Data section. The content variable is 
populated, and the objectld is shown. 


@ isNewPosition(String) <Empty= 

@ isApproved(String) <Empty> 

@ isCompliant(String) <Empty> 

@ requisitionDetails(HiringRequisition) <Empty> 

-| @ content(ECMContentEvent) 

eventClass(ECMEventClass) Document 
objectTypeld(ECMID) IBM_BPM_Document 
relatedObjectld(ECMID) <Empty> 
relatedObjectTypeld(ECMID) <Empty> 
relatedObjectClass(ECMEventClass) <Empty> 
repositoryld(ECMID) {10C21AF6-7D1D-4829-9F2D-835A9310916C} 
serverName(String) EMBEDDED_ECM_SERVER 
eventType(ECMEventType) Created 


objectiId(ECMID) idd_C085756A-0000-C31F-BD55-9C4565685B52 
aaeaeneeee eee 


The creation of the document in the internal document repository triggers the creation of 
the instance. If you created this functionality as part of a production development effort, 
the next step inside the process is to associate the document with the instance. You 


would then create the step when the instance is complete and persist the document to 
an ECM server. 


___ 12. Clean up your environment 


__a. Stop the process by clicking the Terminate icon. 


) Hiring Request 
Process:320 
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Exercise 13. Handling content events in a process 


__b. Click Yes when presented with the confirmation dialogue. 


Confirm Terminate Action 


You cannot restart a process after itis terminated. Do you wantto 
terminate the ‘Hiring Request Process:320' process? 


|| @ 
— 


__c. The process is now in a Terminate status. 


__d. Click the Delete icon to delete the process instance. 


@ Hiring Request 
Process:320 


Vv Details 


Instance ID: 320 
Process Ano: HR Recruitment Process 
Stan ume: May 1, 2019 6:31 PM (16 


hours ago) 

Lastaction: May 2,2019 10:32 AM (> 1 
minute ago) 

Due date: May 2, 2019 2:31 AM (8 hours 
ago) 


__@. Click Yes when presented with the confirmation dialogue. 


It is important to clean up the environment to maintain performance service levels. 
Leaving running processes in the environment that are unnecessary can degrade 
performance and cause unnecessary clutter. 
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Exercise 13. Handling content events in a process 


__f. Click Refresh to verify that there are no more process instances. 


Q a Showing 0 of 0 instances 


\ Search Select shown instances | Select all instances | Clear selection oi tiedihcedee  ¥ 


Filter process instances 
by 

No process instances fulfill your search criteria. 
= Status 
[JActive (0) Modify your search filters and then click Refresh. 


[_] Completed (0) 
(Failed (0) 

[_] Suspended (0) 
(_] Terminated (0) 


+ Severity type 
Person 


Name or user name 


Last modified date 
From |Date Time g 
To | Date Time | @ 


@ Information 


If you have extra process instances as a result of testing, you can use the Process Inspector to 
terminate and delete these instances. You can highlight instances that are in the same state and 
perform batch operations that appear to the right. 


Showing 8 of 8 instances 7 processes selected 
Q Select shown instances | Select all instances | Clear selection Sort by: | Date of last action v 


Search 


Status: 
Filter process instances by i 
, : bd e Hiring Request Process:328 + Hiring Request Process irene teat?) 
LJActive (7) ve Hiring Request Process:327 *® Hiring Request Process O belete 
Completed (1) Last modified May 2, 2019 Due May 2, 2019 
u [eae nea 2 RT eee, 

Failed (0) v e "i = 

a Hiring Request Process:326 *& Hiring Request Process 
[Suspended (0) Last modified May 2, 2019 Due May 2, 2019 

[Terminated (0) rr 

T ) Hiring Request Process:325 *& Hiring Request Process 
+) Severity type Last modified May 2, 2019 Due May 2, 2019 

Person v e Hiring Request Process:324 *& Hiring Request Process 


Last modified May 2, 2019 Due May 2, 2019 
Name or user name 


v 6 Hiring Request Process:322 *& Hiring Request Process 


Last modified date Last modified May 2, 2018 Due May 2, 2018 
fe Time v ro 
Biaait| Date ns 0 @ hiring Request Process:323 * Hiring Request Process 
To|bate vue , Last modified May 2, 2018 Due May 2, 2019 
inact cared v 


Vv Hiring Request Process:321 *& Hiring Request Process 
Last modified May 2, 2019 Due May 2, 2019 
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Part 3: Configure the Document Viewer to use the Case Manager Target 
Object Store (TOS) 


Up to this point, you configured an out-of-the box use of the local BPM document store. However, 
Case Manager has an object store of its own that can be shared between Case solutions and BPM 
solutions. 


Management would like to see how content can be shared between a Case solution and a BPM 
solution. Specifically, management would like to see how a Case solution can trigger the new HR 
structured process solution and share documents between the two solutions by using one content 
repository. 


As part of this exercise, you create a simple, bare-bones Case solution that starts the Hiring 
Request Process from the HR Recruitment Process BPM solution. To do this, you add the Hiring 
Request Process as an activity to the Case solution. 


In this section, you also define an ECM server that points to the Case Manager target object store 
(TOS). Then, you reuse what you built in the Hiring Request From Document coach and configure 
the view to display the Case Manager target object store instead of the BPM document store. Then, 
you test the integration between the Case solution and the BPM solution by adding a new case and 
document to the Case. After the document is added, you verify that the Hiring Request Process 
was Started and that the newly configured view displays the new document in the document list. 


__ 1. Define the new ECM server to use the Case Manager target object store. 


INSPECTOR 


__b. Open the Process App Settings by selecting it from the drop-down list. 


__a. Return to the Designer tab. 


DESIGNER INSPECTOR 


[™ Process App Settinas v ) @ 


[¥ Process App Settings 


@ Hiring Request From Document (x) + Variables 


Gz) Hiring Request Process ® 
e-wa Hiring Request Document Start ® 
ow . 


WUIVvUin 


__c. Select the Servers tab. 
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d. Click Add a new server. 


Overview 


Exercise 13. Handling content events in a process 


Environment Variables Servers Ul Conversion 


Y Servers 
CancelHiringRequestWSServer 
x 


e. Configure the new server with the following information: 


Field Value 

Name ECM_TOS 

Type Enterprise Content Management 
Server 

Description ECM Target Object Store 

Host name wS2016x64 

Port 9443 

Context path /fncmis 

Secure server checked 

Repository tos 

User ID author1 

Password passwOrd 

Always use this connection information checked 


© Copyright IBM Corp. 2019 


Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


13-28 


Exercise 13. Handling content events in a process 


__ 2. Create the ECM document authorization service. 


__a. Click New next to ECM document authorization service. 


Name ECM_TOS 
Type Enterprise Content Management Server v 
Description BIU/ZESSB|(|F EEE 
ECM Target Object Store 

Default @ 
Host name: ws2016x64 
Port 9443 
Context path: fincmis 
Secure server: M 
Repository: tos 
User ID: author 
Password: eeccccce 
Always use this connection information: MY 
ECM document authorization service: <none> [Setect[[ New. ]]x 
Event broadcasters: <none> x 
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__b. Name the new Service Flow ECM DocAuth Service and click FINISH. 


New Service Flow 


A service flow lets you build, test, and run a set of services. Learn More 


Name: |ECM DocAuth Service 


Use as ateam service 


__c. Select the End event. 
__d. Select the Pre & Post properties menu. 


__e. Enter the following for the Pre-Execution Script: tw. local.authorized = true 


#” ECM DocAuth Service ~ ® @ Last updated seconds ago by you 


Overview Diagram Variables Decisions 


General 


implementation Y  Pre-Execution Script 


Pre & Post Add JavaScript code that runs before the selected activity or event runs 
ltw.local.authorized = true 


__f. Save your work. 
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__g. Close the ECM DocAuth Service window. 


| 
# ECM DocAuth Service v 


__h. Return to the ECM_TOS configuration. 
___ 3. Configure the new ECM server to broadcast events to all users and test the connection. 
__a. Click Select next to Event broadcasters and select All Users. 


__b. Verify your configuration and save your work. 


Y Details | 
Name ECM_TOS 
Type Enterprise Content Management Server v 
Description BIU | SSBSSSl(E Slt Se 

ECM Design Object Store 

Default @ 
Host name: ws2016x64 
Port: 9443 
Context path: fincmis 
Secure server: 
Repository: tos 
User ID: author 
Password: eeccccce 
Always use this connection information: 
ECM document authorization service: w” ECM DocAuth Service x 
Event broadcasters: 44 All Users | System Data x 


__c. Click Test connection to verify connection to the object store. 
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Click OK on the Information dialogue. 


bs Information 


Connection was successful. 


Now that the server is configured, you can return to the Startable Service coach to 


configure it to use the new ECM_TOS server. 


__ 4. Create the ECM list View 


Return to the Hiring Request From Document service. 


DESIGNER 


[* Process App Settings v 
[ Process App Settings 


I 
i 
|g) Hiring Request Process 


est Document Start () 


ewe Hiring Requ 
ow . 


Overview Variables 


Diagram 


Select the BPM Document List. 
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INSPECTOR 


@& Hiring Request From Document ® t Variables 
& 


@ 


eal wWUiVvuin 


__b. Click on the Coach downward arrow and select Coach. 


Coach, Cnoanarh «7 


[coment 
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__d. Under the Behavior section in the General properties tab, click Select next to View. 


cc 


Overview Diagram Variables Coach: Coach v 


BPM Document List 


General 
Positioning Y Common v__ Behavior kK 
Configuration Label: @© BPM Document List Binding: @ ecmDocument (ECMDocumentinfo Select. Clear 
Events Help: = © View: (E)BPM Document List cubis ottusnagene | SEEN New. 
Visibility Label visibility: @ | Show ¥ 
HTML Attributes 
Control ID: BPM_Document_List1 
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__e. Enter ecm to filter the selection. Select the ECM Document List view. 


Select Library Item 


ECM File List Content Management 

ECM File Properties Content Management 
ECM File Revisions Content Management 
ECM File Uploader Content Management 
ECM Folder List Content Management 


Because the ECM Document List uses the same content object (ECMDocumentinfo), 
you can leave the binding as is. 
__f. Rename the view to ECM Document List. 


___g. Click the Configuration properties tab and expand Content management advanced. 


__h._ Enter ECM_TOS for the ECM server configuration name. 


¥ Content management advanced 


ECM server configuration name: @]} ECM_TOS 


Document object type ID: tf) 
Folder path: © 


__i. Save your work. 
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Part 4: Build Case solution 


Although this course does not cover Case Management development, it is important to understand 
how the integration works between a Case solution and a BPM solution. 


In this section, you build a simple, bare-bones Case solution by using the enhanced Workflow 
Center and Case Builder. You only create the necessary components to run the solution and test 
integration between the Case and the BPM solution. 


__1. Create a new case solution 

a. Open a new tab in the browser. 

__b. Inthe URL field, enter https: //ws2016x64: 9443/WorkflowCenter 
__c.__ If prompted, log in to the enhanced Workflow Center as author1/ passwOrd 


d. Click the plus icon to create a new Case solution. 


IBM Business Automation Workflow Center gl se} author 


Welcome to Business Automation Workflow Center 


Create a new project or take a look at existing ones to get started! 


ha 7 


Process Apps Case Solutions Toolkits 


o o 


e. Name the solution: HR Case Solution 
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__f. Click Create. The solution is opened in IBM Business Automation Workflow Case 
Builder. 


Create a case solution 


Name @ ns 


HR Case Solution 


Acronym @ 


HRCAS 


Open in Designer 


Select a base template and snapshot (Optional) 


No Case Templates Available 


o 


__ 2. Add Role 
__a. Click the Roles tab. 
__b. Click Add Role. 


__c. Enter General Manager for the Role. 
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__d. Click OK All. 


HR Case Solution 
Edit solution description 
Solution prefix: HRCAS 
Created by author1 

Created on May 13, 2019 


Properties Roles In-baskets Documents Business Objects Pages Case Types 
* Role’ Description: 


General Managers 


Role Settings Pages 


___ 3. Add Document Class 
__a. Click the Documents tab. 
__b. Click Add Document Class and select New. 
c. Enter HR for Name. 
d. Add HRCLASS to the Unique Identifier 
e. Click OK. 


General 


Adding the new document class 


he 
| * Mama 


L j 


x Unique Identifior 


HRCAS |HRCLASS ] 


Description: 7 


__ 4. Add Case Type 


__a. Click the Case Types tab 
__b. Click Add Case Type. The Case is opened in a new editor 


__c. Enter HR for the Case type name. 


© Copyright IBM Corp. 2019 13-37 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 13. Handling content events in a process 


__d. Click Activities. 
a) Manage Solutions \ HR Case Solu... \ HR 
@ Case Type 
f=) Properties @ Case Type Attributes 
| Views 


' Case type name: 


|=| Stages a iat oe 
* Case type unique identifier: 
© Rules HRCAS_ HR | 


a 


Case type description: 


Starting document class: 


<None> 


__ 5. Add Activity 
__a. Click Add Activity and select Activity with Existing Process 


@ Manage Solutions \ HR Case Solu... \ HR 


@ Case Type 


[© Properties O Add Activity ’ Manage Sets 


i Views Activity with New Process 


Add Container 


|=.| Stages 


Activity with New FileNet P8 Process 
> Activities pez =~ 
Activity with Existing FileNet P8 Process 


b. Enter Hiring Request Process as the Name. 
c. Enter the following for description: 


This activity starts the Hiring Request Process of the HR Recruitment 
Process BPM solution. 


© Copyright IBM Corp. 2019 13-38 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


Exercise 13. Handling content events in a process 


__d. Click Next. 
|Add Activity 


General 


Hiring Request Process 


* Unique Identifier 
HRCAS_ HiringRequestProcess 


Dinan arintinn- 


This activity starts the Hiring Request Process of the 
HR Recruitment Process BPM solution. 


This activity starts: 


@ Automatically © Manually Discretionally 


This activity is: 
["] Hidden 
{-) Required 


Assign to set 


<None> |~ Manage Sets 


Bac | Cancel | Next | 


Click the Preconditions drop down menu and select A document is filed in the case. 
__f. Click the Any document class check box to clear it. 


_e. 


faa) 


__g. Verify that the HR Document Class is selected. 
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__h. Click Next. 
Add Activity 


Preconditions 


What preconditions must be met for this activity to start? 


| A document is filed in the case im {") Activity is repeatable 


{-] Any document class 


The above precondition and the following conditions: 


Add Condition ||] Delete All Conditions Match:) All |v 


Property Operator Value 


v 


Cancel Next 


__i. Click Workflow Project Name and select HR Recruitment Process. 
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__j. Select Hiring Request Process under the list of processes populated below. 


Add Activity 


Workflow Project name: 
HR Recruitment Process v 


Snapshot name: 


Default Version v 


Select a process: 


Open Web Process Designer Filter processes 


Process Name « Description 


Annrove Hire Renuest 


Hiring Request Process 


__k. Click Next. 


__\|. Because there are no properties in the Case, there is no need to map any properties in 
the next screen. Click Finish. The activity is added to the Case. 


Hiring Request Process 


This activity starts the Hiring 
Request Process of the HR 


Precondition 
Documents: HR 


Hee 


Set <None> 


__m. Click Save in the upper right corner. 


author 


__n. Click Back. 
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__ 6. Deploy the Case solution. 


__a. Click Commit in the upper right corner. 


__b. Click Commit My Changes in the Confirmation dialog box. The commit icon turns to a 
green check mark. 
Confirmation 


The following items are locked by you and unavailable for deployment. Do you want to commit your 
changes? 


Type Name 


Solution Roles and in-baskets 


Solution Properties, case types, document classes, business objects, choice 
lists, solution description, solution icon, case folders, case 
summary view, case search view, case stages 


Commit My Changes 


__c. Click Deploy in the upper right corner. 


After successful deployment, the deployment icon changes to a green check mark. 
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Part 5: Test your solution 


In this section, you test the solution, demonstrating the document list view now displays content 
from the Case Manager target object store (TOS) and that the Hiring Request process starts 
when a document is added to the HR Case solution. 


__ 1. Create a new case. 


a. Click Start to run the Case solution. The solution opens in a new window. 


b. Before adding a case to the solution, you need to add yourself as a user to the General 
Manager role. Click HR Case Solution in the top right, expand HR Case Solution, and 


click Manage Roles. 
HR Case Solution “~ 


+ fF HR Case Solution 


Manage Roles 


c. Click Add Users and Groups 
d. Enter author for the search criteria and click the Search icon. 


e. Select author1 and click Add (right arrow). 
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__f. Once author is in the Selected column, click Add. 


Add Users and Groups 


Available 


2 author2 


Add Close 


. 
- 


__g. Verify author1 has been added as a user to the General Manager role and click Save. 


Roles Add Users and Groups 


- Manage Roles 
Members 
o ator You can modify the list of users for each role 


that is associated with this solution 


| Save | 
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__h. Click Add Case, then select HR. 


IBM Business Automation Workflow Case Client author1 


ie Cases V HR Case Solution | General Manager ¥Y 
Cases Work 
HR 
Added On vy No items to display 


5/2/2019, 4:25 PM - 1 process roles were found 


__i. Click Add. 


IBM Business Automation Workflow Case Client 


a Cases VY HR Case Solution | General Manager Y 


Cases Work & Add Case 


HR 
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__j. Amessage stating the new case was successfully created is displayed in the bottom 
status bar. Click Search to list the new case. 


IBM Business Automation Workflow Case Client author 
m= Cases “V HR Case Solution | General Manager ¥Y 
Cases Work 
AddCase Vv a = 
Searct 


Added On a No items to display 


5/2/2019 


Search Advanced Search 


eee 


__ 2. Addadocument to the case. 
__a._ Click the title link for the newly added case. The title link for your case might be different. 


A 


Title Added On Case State Modified By Modified On 


HRCAS HRC_000000100001 5/2/2019, 11:59 AM Working author! 5/2/2019, 1:08 PM 
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__b. Click Add and select Add document from Local System. 


= Cases VW 


Cases Work IX Case HRCAS_HRC_000000110001 


HRCAS HRC _ 000000110001 = Modifica: 5/2/2019, 4:33PM HR 


Documents Activities History 


| Add A | Actions V =— 


Add Folder 


Add Document from Local System 


Add Document from Repository 


c. Inthe Add Document window, click the Browse button, and navigate to: 
C:\labfiles\Support files\Ex13\AAA Employment application. pdf 


d. Select HR for the document class by clicking the Class drop down list, selecting HR, 
then clicking OK. 


~ General 
What do you want to save? Local document v 
* File name Browse... AAA Employment application.pdf 
~ Properties 
*Class:| Document “A 
> Email 
Docurn 
Tit ¢ > HR 
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__e. Verify that the correct class and document have been selected. Then, click Add to add 
the document to the case. 


»~ General 


Save in: 000000110001 v 
What d , The values that you enter for the document 
at do you want to 
sna Local document ind properties can be used to find the document 


later. 


Add Document 


* File name: Browse... | AAA Employment application.padf 


Major version @ 
~ Properties 


Document eee 
Title: @ AAA Employment application.pdf 


Add 


Cancel 


__f. The document is listed as part of the case. 
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__ 3. Validate the status of the started activity. 
__a. Click the Activities tab. 


= Cases VY 


Cases Work IB\ Case HRCAS_HRC_000000110001 


HRCAS HRC _ 000000110001 = Modifica: 5/2/2019, 4:33 PM 


Documents History 


Home 


rr 
I 


AAA Employment application.pdf 
Modified By: author1 | Modified On: 5/2/2019, 5:21PM 


__b. The case reports that the HR process is started. 


Documents Activities History 


Required (1) 


= Hiring Request Process 


started on 5/15/2019, 12:57 PM 


= | 


You have added a case to the existing HR Case solution and added a document to the 
new case. This event started the Hiring Request Process. 


__c. Close the case window by clicking the X in the tab. 


IBM Business Automation Wc 


C a 


__ 4. Verify that the Hiring Request Process is started in Process Portal and that the document is 
listed in the ECM Document List view. 


___a. Open Process Portal. 
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__b. Verify that a Submit Hiring Request task is in the Work page. 
The Hiring Request Process is started from the manual Start Event. 


__c. Click the Hiring Request From Document startable service. 
Launch 


Advanced HR Open New 
Position 


Discover BPM UI 


Hiring Request Process 


ReplenishmentBPD 


Standard HR Open New Position 
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The page might take a minute to load. The AAA Employment application.pdf document 
appears in the list. Your document list might look different. 


Hiring Request From Document 


ECM Document List Load More... Z~sRefresh + Add... 
Name ¢ Last Modified 2 Version 

& | 5/2/2019 | 1.0 oF 
& 4/27/2019 1.0 of 
& 4/27/2019 1.0 or 
& 4/27/2019 1.0 or 
& 4/27/2019 3.0 of 
B 4/27/2019 1.0 oF 
& 4/27/2019 1.0 > 
Ba 4/27/2019 3.0 or 
B&B 4/30/2019 5.0 of 
i 4/30/2019 4.0 of 
OK 


@ Troubleshooting 


If the AAA Employment application.pdf document does not display in the list, you can click Load 
More... to display more documents. You can then sort the documents by name. 


__d. Click OK to close the service. 


You have completed this exercise. 


Part 6: Export the process application 


Now that you have completed all exercises in this course, you might want to consider saving your 
work for future reference. This section covers exporting your process application. After you export 
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your process application, you can optionally copy it from the Downloads folder to your personal IBM 
Box account. For information regarding Box, follow this link: https://ipbm.box.com. 


__ 1. Create a snapshot 
__a. Return to the classic Workflow Center. 
__b. Click the HR Recruitment Process process application. 


__c. Click Create New Snapshot on the right side. 


+f Create New Snapshot 


% Open in Designer 


__d. Enter WB828Solution for the name. 
__e. Click Create. 
__ 2. Export the application. Exporting the application also exports the toolkit that it depends on. 
__a. Click Export next to the WB828Solution snapshot. 
__b. Inthe Export Process App window, click Export. 


Export Process App x 


Select an export file type. 
@) IBM Business Automation Workflow export (.twx) 


IBM Business Automation Workflow Installation Package (.zip) 
BPMN 2.0 export (.zip) 
SAP Solution Manager (deprecated) 


Export 


c. Click OK to save the file. The application is saved to the default folder, which is the 
downloads directory. 


__d._ Verify that the application is listed to the downloads directory. 
This concludes the solution export. 


In the first part of the exercise, you modified an existing process to set up a document start event. 
You created the event subscription and verified the user-generated settings. You then created a 
coach and tested the event subscription. You proved that the document was sent as part of the start 
event output variable. 


You then created an ECM server to point to the Case Manager target object store and reconfigured 
the BPM Document List view to show the new object store. As part of building a simple Case 
solution, you attached the Hiring Request Process from the BPM solution as an activity in the Case. 
Then, you tested the document viewer and integration by running the Case and adding a document 
to the Case. To verify the integration, you viewed the Submit Hiring Request task in the Work page. 
To verify the document viewer, you displayed the new document in the Document List view. 


You have completed all exercises in this course. 
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End of exercise 
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